docs: more masto pointers [ci skip]

This commit is contained in:
decentral1se 2023-02-15 01:59:43 +01:00
parent 3c95b8a5ab
commit 05f3ac602e
Signed by: decentral1se
GPG Key ID: 03789458B3D0C410
1 changed files with 9 additions and 27 deletions

View File

@ -1,8 +1,11 @@
# Hometown
A supported fork of Mastodon that provides local posting and a wider range of content types.
> A supported fork of Mastodon that provides local posting and a wider range of content types.
This repository is a copy of [coop-cloud/mastodon](https://git.autonomic.zone/coop-cloud/mastodon) but with a fresh README and some Hometown specific configuration. It seems like a good idea to keep the deployment separate since the apps may diverge in their deployment or configuration instructions at some point despite best wishes to remain as mainline Mastodon as possible.
The configuration aims to stay as close as possible to [coop-cloud/mastodon](https://git.autonomic.zone/coop-cloud/mastodon).
At some point, ideally, we could merge them. We don't have enough folks running
both Mastodon & Hometown to understand if that is a good idea right now. To be
discussed.
<!-- metadata -->
@ -19,31 +22,10 @@ This repository is a copy of [coop-cloud/mastodon](https://git.autonomic.zone/co
## Basic usage
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. `abra app cmd <domain> secrets --local`
1. `abra app config <domain>`
1. `abra app deploy <domain>`
1. `abra app cmd <domain> 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/<domain>_app/_data
```
And finally, within the `app` container, create an admin account:
```
abra app cmd <domain> admin "<username>" "<email>"
```
See the [`coop-cloud/mastodon` `README.md`](https://git.coopcloud.tech/coop-cloud/mastodon#quick-start).
## Tips & Tricks
See the [`coop-cloud/mastodon` `README.md`](https://git.coopcloud.tech/coop-cloud/mastodon#admin-tips-tricks). Please
only gather tips & tricks that are specific to Hometown here.
See the [`coop-cloud/mastodon` `README.md`](https://git.coopcloud.tech/coop-cloud/mastodon#admin-tips-tricks).
Please only gather tips & tricks that are specific to Hometown here.