aboutsummaryrefslogtreecommitdiff
path: root/doc/src/setup.md
diff options
context:
space:
mode:
authorQuentin Dufour <quentin@deuxfleurs.fr>2022-08-01 10:35:29 +0200
committerQuentin Dufour <quentin@deuxfleurs.fr>2022-08-01 10:35:29 +0200
commit112e63b5d7feb9476b6bd1852dc276bb3de2d0bd (patch)
tree4cae7617506bbd3fe387ebd63b26b3e63bf14f11 /doc/src/setup.md
parent441730e1f7a27541d52d1aaccc59a8204a96d079 (diff)
downloadaerogramme-112e63b5d7feb9476b6bd1852dc276bb3de2d0bd.tar.gz
aerogramme-112e63b5d7feb9476b6bd1852dc276bb3de2d0bd.zip
First iteration on documentation
Diffstat (limited to 'doc/src/setup.md')
-rw-r--r--doc/src/setup.md74
1 files changed, 74 insertions, 0 deletions
diff --git a/doc/src/setup.md b/doc/src/setup.md
new file mode 100644
index 0000000..66a1b7e
--- /dev/null
+++ b/doc/src/setup.md
@@ -0,0 +1,74 @@
+# Setup
+
+You must start by creating a user profile in Garage. Run the following command after adjusting the parameters to your configuration:
+
+```bash
+cargo run -- first-login \
+ --region garage \
+ --k2v-endpoint http://127.0.0.1:3904 \
+ --s3-endpoint http://127.0.0.1:3900 \
+ --aws-access-key-id GK... \
+ --aws-secret-access-key c0ffee... --bucket mailrage-me \
+ --user-secret s3cr3t
+```
+
+The program will interactively ask you some questions and finally generates for you a snippet of configuration:
+
+```
+Please enter your password for key decryption.
+If you are using LDAP login, this must be your LDAP password.
+If you are using the static login provider, enter any password, and this will also become your password for local IMAP access.
+Enter password:
+Confirm password:
+
+Cryptographic key setup is complete.
+
+If you are using the static login provider, add the following section to your .toml configuration file:
+
+[login_static.users.<username>]
+password = "$argon2id$v=19$m=4096,t=3,p=1$..."
+aws_access_key_id = "GK..."
+aws_secret_access_key = "c0ffee..."
+```
+
+In this tutorial, we will use the static login provider (and not the LDAP one).
+We will thus create a config file named `aerogramme.toml` in which we will paste the previous snippet. You also need to enter some other keys. In the end, your file should look like that:
+
+```toml
+s3_endpoint = "http://127.0.0.1:3900"
+k2v_endpoint = "http://127.0.0.1:3904"
+aws_region = "garage"
+
+[login_static]
+default_bucket = "mailrage"
+[login_static.users.me]
+bucket = "mailrage-me"
+user_secret = "s3cr3t"
+alternate_user_secrets = []
+password = "$argon2id$v=19$m=4096,t=3,p=1$..."
+aws_access_key_id = "GK..."
+aws_secret_access_key = "c0ffee..."
+```
+
+If you fear to loose your password, you can backup your key with the following command:
+
+```bash
+cargo run -- show-keys \
+ --region garage \
+ --k2v-endpoint http://127.0.0.1:3904 \
+ --s3-endpoint http://127.0.0.1:3900 \
+ --aws-access-key-id GK... \
+ --aws-secret-access-key c0ffee... \
+ --bucket mailrage-me
+ --user-secret s3cr3t
+```
+
+You will then be asked for your key decryption password:
+
+```
+Enter key decryption password:
+master_key = "..."
+secret_key = "..."
+```
+
+You are now ready to [validate your installation](./validate.md).