Document options in README
authorRoger Braun <rbraun@Bobble.local>
Fri, 15 Sep 2017 12:44:52 +0000 (14:44 +0200)
committerRoger Braun <rbraun@Bobble.local>
Fri, 15 Sep 2017 12:44:52 +0000 (14:44 +0200)
README.md

index a3eb068965a8a7f2699fc674edcd3abe275b50c2..36b4c5133e9f2248b2d60cfc31363176dca890ae 100644 (file)
--- a/README.md
+++ b/README.md
@@ -41,14 +41,15 @@ Elixir will also require `make` and probably other related software for building
      GRANT ALL ON ALL sequences IN SCHEMA public TO pleroma;
      ```
 
-     * Change password in `config/dev.exs`, and change user to `"pleroma"` (line like `username: "postgres"`)
+     * Create `config/dev.secret.exs` and copy the database settings from `dev.exs` there.
+     * Change password in `config/dev.secret.exs`, and change user to `"pleroma"` (line like `username: "postgres"`)
      * Create and update your database with `mix ecto.create && mix ecto.migrate`. If it gives errors, try running again, this is a known issue.
 
 ### Some additional configuration
 
   * You will need to let pleroma instance to know what hostname/url it's running on. _THIS IS THE MOST IMPORTANT STEP. GET THIS WRONG AND YOU'LL HAVE TO RESET YOUR DATABASE_.
 
-    In file `config/dev.exs`, add these lines at the end of the file:
+    Create the file `config/dev.secret.exs`, add these lines at the end of the file:
 
     ```elixir
     config :pleroma, Pleroma.Web.Endpoint,
@@ -57,6 +58,14 @@ Elixir will also require `make` and probably other related software for building
 
     replacing `example.tld` with your (sub)domain
 
+  * You should also setup your site name and admin email address. Look at config.exs for more available options.
+
+    ```elixir
+    config :pleroma, :instance,
+      name: "My great instance",
+      email: "someone@example.com"
+    ```
+
   * The common and convenient way for adding HTTPS is by using Nginx as a reverse proxy. You can look at example Nginx configuration in `installation/pleroma.nginx`. If you need TLS/SSL certificates for HTTPS, you can look get some for free with letsencrypt: https://letsencrypt.org/
   On Debian you can use `certbot` package and command to manage letsencrypt certificates.