documentation/Running-Mastodon/List-of-Rake-tasks.md

60 lines
3.2 KiB
Markdown
Raw Normal View History

2017-07-04 15:26:54 +02:00
# List of Rake tasks
The list of Rake tasks.
If you want to confirm all Rake tasks from command line interface, you can run the following.
```sh
bundle exec rails rake -T
```
2017-07-25 18:04:45 +02:00
**General usage note:** Remember that each command will be invoked in a particular environment (configuration, database). The default environment when nothing is specified is "development". In production, you usually prepend all commands with `RAILS_ENV=production` to opt into the production environment. This is not necessary if you're using the Docker images, because that environment variable is set in the image for you. Similarly, prepending `bundle exec` is not necessary when using Docker. The following invocations are equivalent:
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
Standalone: `RAILS_ENV=production bundle exec rake mastodon:users:admins`
Docker: `docker-compose run --rm web rake mastodon:users:admins`
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
Furthermore, in the command, `rake` is interchangeable with `rails`
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
#### Administrative
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
|Task|Description|Usage|
|----|-----------|-----|
|mastodon:make_admin|Turn a user into an admin|USERNAME=yourname|
|mastodon:confirm_email|Confirm a user manually|USER_EMAIL=your@email|
|mastodon:add_user|Create new user|(Interactive)|
|mastodon:users:admins|List e-mails of all admins|
|mastodon:settings:open_registrations|Open up registrations|
|mastodon:settings:close_registrations|Close down registrations|
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
#### Media Storage
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
|Task|Description|Usage|
|----|-----------|-----|
|mastodon:media:remove_silenced|Purge all media uploads by silenced accounts. Completely removes records, as if their statuses never had attachments|
|mastodon:media:remove_remote|Remove local cache of remote media attachments older than some time period (defaults to 7 days). Removes only cache, record of an attachment existing remains|NUM_DAYS=7|
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
#### E-mails
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
|Task|Description|Usage|
|----|-----------|-----|
|mastodon:emails:digest|Sends out a personal digest to all eligible inactive users. Digest includes mentions since the last time the user was active. No e-mail is sent if there is no new content since last digest or user activity|
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
#### Misc
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
|Task|Description|Usage|
|----|-----------|-----|
|mastodon:push:clear| Normally, a subscription to a once-followed user remains forever, in case the user gets re-followed later. You can purge such subscriptions with 0 followers if you wish|
|mastodon:feeds:clear_all|Purge all home timelines from redis. Useful only for troubleshooting, when e.g. resetting database during development|
|mastodon:feeds:build|Regenerates home timelines for all active users. Useful only for troubleshooting, e.g. if you lost your redis database|
|mastodon:webpush:generate_vapid_key|Generates secrets for WebPush notifications|
#### Data migrations
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
These are one-off tasks for updating from one version of Mastodon to another. They are noted in the particular release's upgrade notes and are not relevant outside of that.
2017-07-04 15:26:54 +02:00
2017-07-25 18:04:45 +02:00
|Task|Description|Usage|
|----|-----------|-----|
|mastodon:media:set_unknown|Only relevant for a past release|
|mastodon:maintenance:update_counter_caches|Only relevant for a past release|
|mastodon:maintenance:add_static_avatars|Only relevant for a past release|
|mastodon:maintenance:prepare_for_foreign_keys|Only relevant for a past release|