From 31bbab60333d3d970b0320270637cf8ee6abac2f Mon Sep 17 00:00:00 2001
From: cellarspoon <cellarspoon@riseup.net>
Date: Thu, 6 Jan 2022 12:38:58 +0100
Subject: [PATCH] docs: tricks & tips

---
 README.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index dda61c1..fd5f675 100644
--- a/README.md
+++ b/README.md
@@ -24,8 +24,22 @@ Wiki and knowledge base for growing teams
 4. `abra app config YOURAPPNAME` - be sure to change `$DOMAIN` to something that resolves to
    your Docker swarm box
 5. `abra app deploy YOURAPPNAME`
-6. Build the database with `abra app run YOURAPPNAME app yarn db:migrate --env=production-ssl-disabled` 
 7. Open the configured domain in your browser to finish set-up
 
 [`abra`]: https://git.coopcloud.tech/coop-cloud/abra
 [`coop-cloud/traefik`]: https://git.coopcloud.tech/coop-cloud/traefik
+
+## Tips & Tricks
+
+### Post-deploy migration
+
+```
+abra app run YOURAPPNAME app sh
+export DATABASE_PASSWORD=$(cat /run/secrets/db_password)
+export DATABASE_URL="postgres://outline:${DATABASE_PASSWORD}@${STACK_NAME}_postgres:5432/outline"
+yarn db:migrate --env=production-ssl-disabled
+```
+
+### Setting up your `.env` config
+
+Don't use quotes (`"..."`), the NodeJS scripts flip out for some reason.