forked from coop-cloud/outline
1.8 KiB
1.8 KiB
Outline
Wiki and knowledge base for growing teams
- Category: Apps
- Status: 1, alpha
- Image: outlinewiki/outline
- Healthcheck: No
- Backups: No
- Email: No
- Tests: No
- SSO: 3 (OAuth)
Basic usage
- Set up Docker Swarm and
abra
- Deploy
coop-cloud/traefik
abra app new ${REPO_NAME} --secrets
(optionally with--pass
if you'd like to save secrets inpass
)abra app config YOURAPPNAME
- be sure to change$DOMAIN
to something that resolves to your Docker swarm boxabra app deploy YOURAPPNAME
- Open the configured domain in your browser to finish set-up
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
Avoid the use of quotes ("..."
) as much as possible, the NodeJS scripts flip out for some reason on some vars.
Multiple users logging in & generic oauth
COMPOSE_FILE="compose.yml:compose.patch.yml"
Deleting a user (e.g. to fix SSO weirdness)
abra app cmd YOURAPPNAME postgres delete_user <username-to-delete> <username-to-replace>
Where <username-to-delete>
is the username of the user to be removed, and
<username-to-replace>
is the username of another user, to assign documents and
revisions to (instead of deleting them).
As of 2022-03-30, this requires abra
RC version, run abra upgrade --rc
.