Initial commit
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..baee1fe
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,91 @@
+=====
+Aptly
+=====
+
+Install and configure Aptly server and client.
+
+Available states
+================
+
+.. contents::
+ :local:
+
+``aptly.server``
+----------------
+
+Setup aptly server
+
+``aptly.publisher``
+-------------------
+
+Setup aptly publisher
+
+Available metadata
+==================
+
+.. contents::
+ :local:
+
+``metadata.aptly.server.single``
+--------------------------------
+
+Setup basic server
+
+
+``metadata.aptly.client.publisher``
+-----------------------------------
+
+Setup aptly publisher client
+
+Configuration parameters
+========================
+
+
+Example reclass
+===============
+
+Basic Aptly server with no repos or mirrors.
+
+.. code-block:: yaml
+
+ classes:
+ - service.aptly.server.single
+ parameters:
+ aptly:
+ server:
+ enabled: true
+ secure: true
+ gpg_keypair_id: A76882D3
+ gpg_passphrase:
+ gpg_public_key: |
+ -----BEGIN PGP PUBLIC KEY BLOCK-----
+ Version: GnuPG v1
+ ...
+ gpg_private_key: |
+ -----BEGIN PGP PRIVATE KEY BLOCK-----
+ Version: GnuPG v1
+ ...
+
+Example pillar
+==============
+
+.. code-block:: yaml
+
+ aptly:
+ server:
+ enabled: true
+ repo:
+ myrepo:
+ distribution: trusty
+ component: main
+ architectures: amd64
+ comment: "Custom components"
+ publisher:
+ component: mycomponent
+ distributions:
+ - nightly/trusty
+
+Read more
+=========
+
+* http://www.aptly.info/doc/configuration/