Create mastodon.md

This commit is contained in:
A 2025-05-05 10:37:59 -07:00 committed by GitHub
parent 8282a1c96c
commit e8f0c4fca6
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

26
docs/mastodon.md Normal file
View File

@ -0,0 +1,26 @@
# Mastodon
## Creating an admin user
How to create an admin user can be found in the [admin cli documentation](https://docs.joinmastodon.org/admin/tootctl/). You will need to run these commands within the `compose-mastodon-web` docker container. Example:
```
tootctl accounts create dcomms-admin --email dcomms-admin@example.org --role Owner --confirmed
```
This will display a automatically generated password that can be used on first login.
## Clearing media and regaining disk space
For speed and longevity of content, Mastodon caches images from remote servers indefinitly. Over time this can lead to significant storage usage of media that is unlikely to be retreived.
Mastodon provides a few cli commands to address this issue. Run commands from the [offical docs](https://docs.joinmastodon.org/admin/tootctl/#media) within the `compose-mastodon-web` docker container to reduce space. Example:
```
tootctl media remove --days 4
```
# Links
* Official docs https://docs.joinmastodon.org/
* A useful guide https://n00q.net/articles/guide-mastodon-hometown/