diff --git a/README.rst b/README.rst
new file mode 100644
index 00000000..fe08eaf9
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,34 @@
+
+ArcH Linux ReposItory MANager
+=============================
+
+Wrapper for managing custom repository inspired by `repo-scripts <https://github.com/arcan1s/repo-scripts>`_.
+
+Features
+--------
+
+* Install-configure-forget manager for own repository.
+* Multi-architecture support.
+* VCS packages support.
+* Sign support with gpg (repository, package, per package settings).
+* Synchronization to remote services (rsync, s3 and github) and report generation (email, html, telegram).
+* Dependency manager.
+* Ability to patch AUR packages and even create package from local PKGBUILDs.
+* Repository status interface with optional authorization and control options:
+
+  .. image:: web.png
+     :target: web.png
+     :alt: web interface
+
+Installation and run
+--------------------
+
+For installation details please refer to the `documentation <docs/setup.md>`_. For command help, ``--help`` subcommand must be used. Subcommands have own help message as well. The package also provides a `man page <docs/ahriman.1>`_.
+
+Configuration
+-------------
+
+Every available option is described in the `documentation <docs/configuration.md>`_.
+
+`FAQ <docs/faq.md>`_
+------------------------