From 51d3d82a5446c8dbd3ca80f60e69addca407a625 Mon Sep 17 00:00:00 2001
From: teru <teru@kteru.net>
Date: Mon, 15 Aug 2016 14:48:17 +0900
Subject: [PATCH] Write README.md

---
 README.md | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 61 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 1151d6f..3106b9c 100644
--- a/README.md
+++ b/README.md
@@ -3,4 +3,64 @@ mailfull-go
 
 A management tool for virtual domain email for Postfix and Dovecot written in Go.
 
-**Currently in development.**
+Features
+--------
+
+- You can use both virtual users and system users.
+- Mailfull does not involve in delivery processes of the MTA, is only to generate configuration databases.
+- You do not need to restart Postfix/Dovecot to apply configuration databases.
+- The received email can be passed to the programs.
+
+Installation
+------------
+
+### go get
+
+Installed in `$GOPATH/bin`
+
+```
+$ go get github.com/directorz/mailfull-go/cmd/mailfull
+```
+
+Quick Start
+-----------
+
+Create a new user for Mailfull.
+
+```
+# useradd -r -s /bin/bash mailfull
+# su - mailfull
+```
+
+Initialize a directory as a Mailfull repository.
+
+```
+$ mkdir /path/to/repo && cd /path/to/repo
+$ mailfull init
+```
+
+Generate configurations for Postfix and Dovecot. (Edit as needed.)
+
+```
+$ mailfull genconfig postfix > /etc/postfix/main.cf
+$ mailfull genconfig dovecot > /etc/dovecot/dovecot.conf
+```
+
+Start Postfix and Dovecot.
+
+```
+# systemctl start postfix.service
+# systemctl start dovecot.service
+```
+
+Add a new domain and user.
+
+```
+# cd /path/to/repo
+
+# mailfull domainadd example.com
+# mailfull useradd hoge@example.com
+# mailfull userpasswd hoge@example.com
+```
+
+Enjoy!