coop-cloud/hometown
coop-cloud
/
hometown
1
0
Fork 2
Code Issues 1 Pull Requests Projects Releases Activity

docs: "modern" abra docs

This commit is contained in:
decentral1se 2023-02-15 01:36:59 +01:00
parent a325717dcd
commit a86a32fa65
Signed by: decentral1se
GPG Key ID: 03789458B3D0C410
1 changed files with 13 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
README.md
View File

@ -19,46 +19,30 @@ This repository is a copy of [coop-cloud/mastodon](https://git.autonomic.zone/co
## Basic usage
1. Set up Docker Swarm and [`abra`]
1. Deploy [`coop-cloud/traefik`]
Hometown expects secrets to be formatted in a very specific way, so please
choose "No" when prompted to generate secrets for `abra app new mastodon`. The
secrets must be generated outside of `abra` and that is achieved in step 2. See
the [`abra.sh`](./abra.sh) for more.
1. `abra app new mastodon`
1. Follow the [secrets setup docs](#secrets-setup)
1. `abra app config YOURAPPDOMAIN` - be sure to change `DOMAIN` to something that resolves to your Docker swarm box
1. `abra app deploy YOURAPPDOMAIN` to deploy the app
1. `abra app cmd <domain> secrets --local`
1. `abra app config <domain>`
1. `abra app deploy <domain>`
1. `abra app cmd <domain> setup`
You'll need to run a `docker exec -it <streaming-service-id> /bin/bash` and do the following:
Then, on your host (outside of the containers), you'll need to fix permissions
for the volume (see [#2](https://git.autonomic.zone/coop-cloud/hometown/issues/2)):
```
export OTP_SECRET=$(cat /run/secrets/otp_secret)
export SECRET_KEY_BASE=$(cat /run/secrets/secret_key_base)
export DB_PASS=$(cat /run/secrets/db_password)
bundle exec rake db:setup
```
Then, on your host (outside of the containers), you'll need to fix permissions for the volume (see [#2](https://git.autonomic.zone/coop-cloud/hometown/issues/2)):
```
chown -R 991:991 /var/lib/docker/volumes/<service-name>_app/_data
chown -R 991:991 /var/lib/docker/volumes/<domain>_app/_data
```
And finally, within the `app` container, create an admin account:
```
export OTP_SECRET=$(cat /run/secrets/otp_secret)
export SECRET_KEY_BASE=$(cat /run/secrets/secret_key_base)
export DB_PASS=$(cat /run/secrets/db_password)
tootctl accounts create <username> --email <email> --confirmed --role admin
abra app cmd <domain> admin "<username>" "<email>"
```
[`abra`]: https://git.autonomic.zone/autonomic-cooperative/abra
[`coop-cloud/traefik`]: https://git.autonomic.zone/coop-cloud/traefik
## Secrets setup
Mastodon expects secrets generated by specific tools. Uou can run these commands via the scripts interface with `abra`.
`abra app cmd <domain> secrets --local`
## Tips & Tricks
### Auto-complete is not working?