Resolve "Small baserow docker doc + docker improvements"

docker-compose.yml

@@ -49,6 +49,13 @@ services:
       - DATABASE_NAME=${DATABASE_NAME:-baserow}
       - ADDITIONAL_APPS
       - MEDIA_URL=http://localhost:${MEDIA_PORT:-4000}/media/
+      - EMAIL_SMTP
+      - EMAIL_SMTP_HOST
+      - EMAIL_SMTP_PORT
+      - EMAIL_SMPT_USE_TLS
+      - EMAIL_SMTP_USER
+      - EMAIL_SMTP_PASSWORD
+      - FROM_EMAIL
     ports:
       - "${BACKEND_PORT:-8000}:8000"
     depends_on:
@@ -70,6 +77,15 @@ services:
     command: celery
     depends_on:
       - backend
+    environment:
+      - ADDITIONAL_APPS
+      - EMAIL_SMTP
+      - EMAIL_SMTP_HOST
+      - EMAIL_SMTP_PORT
+      - EMAIL_SMPT_USE_TLS
+      - EMAIL_SMTP_USER
+      - EMAIL_SMTP_PASSWORD
+      - FROM_EMAIL
     volumes:
       - media:/baserow/media
     networks:

docs/development/running-the-dev-environment.md

@@ -24,6 +24,9 @@ If you haven't already installed docker and docker-compose on your computer you
 so by following the instructions on https://docs.docker.com/desktop/ and
 https://docs.docker.com/compose/install/.
 
+> Docker version 20.10.0 is the minimum required to build Baserow. Please check that 
+> your docker is up to date by running `docker -v`.
+
 You will also need git installed which you can do by following the instructions on
 https://www.linode.com/docs/development/version-control/how-to-install-git-on-linux-mac-and-windows/
 .
@@ -33,9 +36,9 @@ the following commands in your terminal.
 
 ```
 $ docker -v
-Docker version 19.03.8, build afacb8b
+Docker version 20.10.6, build 370c289
 $ docker-compose -v
-docker-compose version 1.25.5, build 8a1c60f6
+docker-compose version 1.26.2, build eefe0d31
 $ git --version
 git version 2.24.3 (Apple Git-128)
 ```

docs/guides/baserow-docker-how-to.md

@@ -3,6 +3,9 @@
 Find below a list of FAQs and common operations when working with Baserow's docker
 environment.
 
+> Docker version 20.10.0 is the minimum required to build Baserow. Please check that
+> your docker is up to date by running `docker -v`.
+
 See [baserow's docker api](../reference/baserow-docker-api.md) for the full details on
 what commands and environment variables baserow's docker-compose and docker image's
 support.
@@ -53,6 +56,16 @@ $ # or using dev.sh
 $ POSTGRES_PORT=5555 REDIS_PORT=6666 MJML_PORT=7777 ./dev.sh
 ```
 
+### Configure an external email server
+
+See [the introduction](../getting-started/introduction.md) for the all the of email
+environment variables available to configure Baserow. For a simple example you can start
+up Baserow locally and have it connect to an external SMTP server like so:
+
+```bash
+EMAIL_SMTP_HOST=TODO EMAIL_SMTP_PORT=TODO EMAIL_SMTP=True docker-compose up
+```
+
 ### Change the container user
 
 When running the dev env you can set the `UID` and `GID` environment variables when
@@ -116,6 +129,13 @@ $ ./dev.sh run backend manage sync_templates
 
 ## Common Problems
 
+### Build Error - Service 'backend' failed to build: unable to convert uid/gid chown
+
+This error occurs when attempting to build Baserow's docker images with a version of
+Docker earlier than 20.10.0. You can check your local docker version by
+running `docker -v` and fix the error by installing the latest version of Docker from
+https://docs.docker.com/get-docker/.
+
 ### Permission denied errors
 
 If you used Baserow's dev env prior to April 2021 with the provided docker files you

docs/guides/running-baserow-locally.md

@@ -21,6 +21,9 @@ If you haven't already installed docker and docker-compose on your computer you
 so by following the instructions on https://docs.docker.com/desktop/ and 
 https://docs.docker.com/compose/install/.
 
+> Docker version 20.10.0 is the minimum required to build Baserow. Please ensure your
+> your docker is up to date by running `docker -v`.
+
 You will also need git installed which you can do by following the instructions on 
 https://www.linode.com/docs/development/version-control/how-to-install-git-on-linux-mac-and-windows/.
 
@@ -29,9 +32,9 @@ following commands in your terminal.
 
 ```
 $ docker -v
-Docker version 19.03.8, build afacb8b
+Docker version 20.10.6, build 370c289
 $ docker-compose -v
-docker-compose version 1.25.5, build 8a1c60f6
+docker-compose version 1.26.2, build eefe0d31
 $ git --version
 git version 2.24.3 (Apple Git-128)
 ```

docs/reference/baserow-docker-api.md

@@ -125,6 +125,24 @@ Backend configuration:
   it will run the baserow management command `sync_templates` which loads any templates
   found in `./backend/templates` into Baserow.
   
+Pass through variables:
+
+These environment variables when provided to the docker-compose files are passed through
+to the correct containers. See [the introduction](../getting-started/introduction.md) 
+for what these variables do.
+
+- `PUBLIC_BACKEND_URL`
+- `PUBLIC_WEB_FRONTEND_URL`
+- `MEDIA_URL`
+- `EMAIL_SMTP`
+- `EMAIL_SMTP_HOST`
+- `EMAIL_SMTP_PORT`
+- `EMAIL_SMPT_USE_TLS`
+- `EMAIL_SMTP_USER`
+- `EMAIL_SMTP_PASSWORD`
+- `FROM_EMAIL`
+
+
 ### Dev Only Variables
 
 - `UID` (default `1000` or your user id when using `./dev.sh`) : Sets which user id will