mastodon

mastodon

Docker app from linuxserver's Repository

Overview

Mastodon(https://github.com/mastodon/mastodon/) is a free, open-source social network server based on ActivityPub where users can follow friends and discover new ones..

Runtime arguments

Network
bridge
Shell
bash
Privileged
false

Template configuration

WebUIPorttcp

Port for web frontend

Target
80
Default
80
Port: 443Porttcp

Port for web frontend

Target
443
Default
443
Port: 9394Porttcp

Port for Prometheus metrics

Target
9394
Default
9394
AppdataPathrw

Contains all relevant configuration files.

Target
/config
LOCAL_DOMAINVariable

This is the unique identifier of your server in the network. It cannot be safely changed later.

Default
example.com
REDIS_HOSTVariable

Redis server hostname

Default
redis
REDIS_PORTVariable

Redis port

Default
6379
DB_HOSTVariable

Postgres database hostname

Default
db
DB_USERVariable

Postgres username

Default
mastodon
DB_NAMEVariable

Postgres db name

Default
mastodon
DB_PASSVariable

Postgres password

Default
mastodon
DB_PORTVariable

Postgres port

Default
5432
ES_ENABLEDVariable

Enable or disable Elasticsearch (requires a separate ES instance)

Default
false
ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEYVariable

Primary key for Active Record Encryption(https://github.com/mastodon/mastodon/pull/29831/files).

ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEYVariable

Deterministic key for Active Record Encryption(https://github.com/mastodon/mastodon/pull/29831/files).

ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALTVariable

Derivation salt for Active Record Encryption(https://github.com/mastodon/mastodon/pull/29831/files).

SECRET_KEY_BASEVariable

Browser session secret. Changing it will break all active browser sessions.

OTP_SECRETVariable

MFA secret. Changing it after initial setup will break two-factor authentication.

VAPID_PRIVATE_KEYVariable

Push notification private key. Changing it after initial setup will break push notifications.

VAPID_PUBLIC_KEYVariable

Push notification public key. Changing it after initial setup will break push notifications.

SMTP_SERVERVariable

SMTP server for email notifications

Default
mail.example.com
SMTP_PORTVariable

SMTP server port

Default
25
SMTP_LOGINVariable

SMTP username

SMTP_PASSWORDVariable

SMTP password

SMTP_FROM_ADDRESSVariable

From address for emails send from Mastodon

Default
notifications@example.com
S3_ENABLEDVariable

Enable or disable S3 storage of uploaded files

Default
false
WEB_DOMAINVariable

This can be set if you want your server identifier to be different to the subdomain hosting Mastodon. See https://docs.joinmastodon.org/admin/config/#basic(https://docs.joinmastodon.org/admin/config/#basic)

Default
mastodon.example.com
ES_HOSTVariable

Elasticsearch server hostname

Default
es
ES_PORTVariable

Elasticsearch port

Default
9200
ES_USERVariable

Elasticsearch username

Default
elastic
ES_PASSVariable

Elasticsearch password

Default
elastic
S3_BUCKETVariable

S3 bucket hostname

AWS_ACCESS_KEY_IDVariable

S3 bucket access key ID

AWS_SECRET_ACCESS_KEYVariable

S3 bucket secret access key

S3_ALIAS_HOSTVariable

Alternate hostname for object fetching if you are front the S3 connections.

SIDEKIQ_ONLYVariable

Only run the sidekiq service in this container instance. For large scale instances that need better queue handling.

Default
false
SIDEKIQ_QUEUEVariable

The name of the sidekiq queue to run in this container. See notes(https://docs.joinmastodon.org/admin/scaling/#sidekiq-queues).

SIDEKIQ_DEFAULTVariable

Set to `true` on the main container if you're running additional sidekiq instances. It will run the `default` queue.

Default
false
SIDEKIQ_THREADSVariable

The number of threads for sidekiq to use. See notes(https://docs.joinmastodon.org/admin/scaling/#sidekiq-threads).

Default
5
DB_POOLVariable

The size of the DB connection pool, must be *at least* the same as `SIDEKIQ_THREADS`. See notes(https://docs.joinmastodon.org/admin/scaling/#sidekiq-threads).

Default
5
NO_CHOWNVariable

Set to `true` to skip chown of /config on init. *READ THE APPLICATION NOTES BEFORE SETTING THIS*.

MASTODON_PROMETHEUS_EXPORTER_ENABLEDVariable

If set to `true`, Mastodon’s Ruby processes (web and Sidekiq) will enable the Prometheus instrumentation.

PUIDVariable

Container Variable: PUID

Default
99
PGIDVariable

Container Variable: PGID

Default
100
UMASKVariable

Container Variable: UMASK

Default
022

Download Statistics

235,098
Total Downloads
14,749
This Month
7,927
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
lscr.io/linuxserver/mastodon
Last Updated2026-05-28
First Seen2022-11-08

Run Mastodon on Unraid.

Mastodon is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.