From 8124dcf0812e3bd08dda9c4492289b0cbccb45b6 Mon Sep 17 00:00:00 2001
From: tobi <31960611+tsmethurst@users.noreply.github.com>
Date: Mon, 9 May 2022 11:15:46 +0200
Subject: [PATCH] [Documentation] tidy docker-compose docs, add note about
 uid/gid (#551)

---
 docs/installation_guide/docker.md | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/installation_guide/docker.md b/docs/installation_guide/docker.md
index cea3947c1..0cb9390ac 100644
--- a/docs/installation_guide/docker.md
+++ b/docs/installation_guide/docker.md
@@ -58,9 +58,9 @@ First open the docker-compose.yaml file in your editor of choice. For example:
 nano docker-compose.yaml
 ```
 
-Now, you should change the `GTS_HOST` environment variable to the domain you are running GoToSocial on.
+#### Version
 
-You should also update the GoToSocial version number to use the latest stable release.
+First, you should update the GoToSocial version number to the latest stable release.
 
 The list of releases can be found [right here](https://github.com/superseriousbusiness/gotosocial/releases), with the newest release at the top.
 
@@ -76,6 +76,18 @@ with:
 image: superseriousbusiness/gotosocial:0.3.1
 ```
 
+#### Host
+
+Change the `GTS_HOST` environment variable to the domain you are running GoToSocial on.
+
+#### User (optional / probably not necessary)
+
+By default, Dockerized GoToSocial runs with Linux user/group `1000:1000`, which is fine in most cases. If you want to run as a different user/group, you should change the `user` field in the docker-compose.yaml accordingly.
+
+For example, let's say you created the `~/gotosocial/data` directory for a user with id `1001`, and group id `1001`. If you now try to run GoToSocial without changing the `user` field, it will get a permissions error trying to open its database file in the directory. In this case, you would have to change the `user` field of the docker compose file to `1001:1001`.
+
+#### LetsEncrypt (optional)
+
 If you want to use [LetsEncrypt](../configuration/letsencrypt.md) for ssl certificates (https), you should also:
 
 1. Change the value of `GTS_LETSENCRYPT_ENABLED` to `"true"`.