83 lines
2.9 KiB
Markdown
83 lines
2.9 KiB
Markdown
Administration guide
|
|
====================
|
|
|
|
So, you have a working Mastodon instance... now what?
|
|
|
|
## Turning into an admin
|
|
|
|
The following rake task:
|
|
|
|
RAILS_ENV=production bundle exec rails mastodon:make_admin USERNAME=alice
|
|
|
|
or, if using docker:
|
|
|
|
docker-compose run --rm web rails mastodon:make_admin USERNAME=alice
|
|
|
|
|
|
Would turn the local user "alice" into an admin.
|
|
|
|
## Administration web interface
|
|
|
|
A user that is designated as `admin = TRUE` in the database is able to access a suite of administration tools:
|
|
|
|
* View, edit, silence, or suspend users - https://yourmastodon.instance/admin/accounts
|
|
* View PubSubHubbub subscriptions - https://yourmastodon.instance/admin/pubsubhubbub
|
|
* View domain blocks - https://yourmastodon.instance/admin/domain_blocks
|
|
* Sidekiq dashboard - https://yourmastodon.instance/sidekiq
|
|
* PGHero dashboard for PostgreSQL - https://yourmastodon.instance/pghero
|
|
* Edit site settings - https://yourmastodon.instance/admin/settings
|
|
|
|
## Site settings
|
|
|
|
Your site settings are stored in the `settings` database table, and editable through the admin interface at https://yourmastodon.instance/admin/settings.
|
|
|
|
You are able to set the following settings:
|
|
|
|
- Site title
|
|
- Contact username
|
|
- Contact email
|
|
- Site description
|
|
- Site extended description
|
|
|
|
You may wish to use the extended description (shown at https://yourmastodon.instance/about/more ) to display content guidelines or a user agreement (see https://mastodon.social/about/more for an example).
|
|
|
|
## Confirming Users Manually
|
|
|
|
The following rake task:
|
|
|
|
RAILS_ENV=production bundle exec rails mastodon:confirm_email USER_EMAIL=alice@alice.com
|
|
|
|
Will confirm a user manually, in case they don't have access to their confirmation email for whatever reason.
|
|
|
|
## Clearing Unconfirmed Users Manually
|
|
|
|
RAILS_ENV=production rake mastodon:users:clear
|
|
|
|
Will remove users that never confirmed their e-mail and never signed in, meaning they
|
|
only have a user record and an avatar record, with no files uploaded.
|
|
|
|
## Creating Users while Registration is Closed
|
|
|
|
RAILS_ENV=production bundle exec rails c
|
|
account = Account.create!(username: 'username')
|
|
user = User.create!(email: 'email', password: 'password', account: account)
|
|
user.confirm
|
|
account.save!
|
|
user.save!
|
|
|
|
This will create a new user as if they had walked through the registration process and confirmed their account, and will immediately be able to log in. Make sure the user resets their password away from the temporary password you give them!
|
|
|
|
## Activity monitoring
|
|
|
|
Munin graphs can be generated to track your instance activity.
|
|
|
|
* https://github.com/cquest/mastodon-munin-plugins
|
|
* https://framagit.org/framasoft/munin-plugins/tree/master/mastodon
|
|
* https://github.com/0xa/mastodon-munin
|
|
|
|
## Mastodon-admin mailing list
|
|
|
|
There's a mailing list open for mastodon instance admins at
|
|
https://lists.ffdn.org/wws/info/mastodon-admin. Feel free to join that list for all your questions and to get some feedback
|
|
from other admins!
|