mastodon

v4.7.3-ls218

mastodon is a free, open-source social network server based on ActivityPub where users can follow friends and discover new ones..

Social

docker pull lscr.io/linuxserver/mastodon:latest

Quick start

Generated from the image's own configuration. Replace the /path/to folders with real paths on your host.

Include optional settings

---
services:
  mastodon:
    image: lscr.io/linuxserver/mastodon:latest
    container_name: mastodon
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - LOCAL_DOMAIN=example.com
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - DB_HOST=db
      - DB_USER=mastodon
      - DB_NAME=mastodon
      - DB_PASS=mastodon
      - DB_PORT=5432
      - ES_ENABLED=false
      - ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY=
      - ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY=
      - ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT=
      - SECRET_KEY_BASE=
      - OTP_SECRET=
      - VAPID_PRIVATE_KEY=
      - VAPID_PUBLIC_KEY=
      - SMTP_SERVER=mail.example.com
      - SMTP_PORT=25
      - SMTP_LOGIN=
      - SMTP_PASSWORD=
      - SMTP_FROM_ADDRESS=notifications@example.com
      - S3_ENABLED=false
      - WEB_DOMAIN=mastodon.example.com # optional
      - ES_HOST=es # optional
      - ES_PORT=9200 # optional
      - ES_USER=elastic # optional
      - ES_PASS=elastic # optional
      - S3_BUCKET= # optional
      - AWS_ACCESS_KEY_ID= # optional
      - AWS_SECRET_ACCESS_KEY= # optional
      - S3_ALIAS_HOST= # optional
      - SIDEKIQ_ONLY=false # optional
      - SIDEKIQ_QUEUE= # optional
      - SIDEKIQ_DEFAULT=false # optional
      - SIDEKIQ_THREADS=5 # optional
      - DB_POOL=5 # optional
      - NO_CHOWN= # optional
      - MASTODON_PROMETHEUS_EXPORTER_ENABLED= # optional
    volumes:
      - /path/to/mastodon/config:/config
    ports:
      - 80:80
      - 443:443
      - 9394:9394 # optional
    restart: unless-stopped

Parameters

Ports
Port	Function	Required
80:80	Port for web frontend	required
443:443	Port for web frontend	required
9394:9394	Port for Prometheus metrics	optional

Environment variables
Variable	Function	Required
PUID=1000	User ID	required
PGID=1000	Group ID	required
TZ=Etc/UTC	Timezone	required
LOCAL_DOMAIN=example.com	This is the unique identifier of your server in the network. It cannot be safely changed later.	required
REDIS_HOST=redis	Redis server hostname	required
REDIS_PORT=6379	Redis port	required
DB_HOST=db	Postgres database hostname	required
DB_USER=mastodon	Postgres username	required
DB_NAME=mastodon	Postgres db name	required
DB_PASS=mastodon	Postgres password	required
DB_PORT=5432	Postgres port	required
ES_ENABLED=false	Enable or disable Elasticsearch (requires a separate ES instance)	required
ACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY=	Primary key for [Active Record Encryption](https://github.com/mastodon/mastodon/pull/29831/files).	required
ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEY=	Deterministic key for [Active Record Encryption](https://github.com/mastodon/mastodon/pull/29831/files).	required
ACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALT=	Derivation salt for [Active Record Encryption](https://github.com/mastodon/mastodon/pull/29831/files).	required
SECRET_KEY_BASE=	Browser session secret. Changing it will break all active browser sessions.	required
OTP_SECRET=	MFA secret. Changing it after initial setup will break two-factor authentication.	required
VAPID_PRIVATE_KEY=	Push notification private key. Changing it after initial setup will break push notifications.	required
VAPID_PUBLIC_KEY=	Push notification public key. Changing it after initial setup will break push notifications.	required
SMTP_SERVER=mail.example.com	SMTP server for email notifications	required
SMTP_PORT=25	SMTP server port	required
SMTP_LOGIN=	SMTP username	required
SMTP_PASSWORD=	SMTP password	required
SMTP_FROM_ADDRESS=notifications@example.com	From address for emails send from Mastodon	required
S3_ENABLED=false	Enable or disable S3 storage of uploaded files	required
WEB_DOMAIN=mastodon.example.com	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)	optional
ES_HOST=es	Elasticsearch server hostname	optional
ES_PORT=9200	Elasticsearch port	optional
ES_USER=elastic	Elasticsearch username	optional
ES_PASS=elastic	Elasticsearch password	optional
S3_BUCKET=	S3 bucket hostname	optional
AWS_ACCESS_KEY_ID=	S3 bucket access key ID	optional
AWS_SECRET_ACCESS_KEY=	S3 bucket secret access key	optional
S3_ALIAS_HOST=	Alternate hostname for object fetching if you are front the S3 connections.	optional
SIDEKIQ_ONLY=false	Only run the sidekiq service in this container instance. For large scale instances that need better queue handling.	optional
SIDEKIQ_QUEUE=	The name of the sidekiq queue to run in this container. See [notes](https://docs.joinmastodon.org/admin/scaling/#sidekiq-queues).	optional
SIDEKIQ_DEFAULT=false	Set to `true` on the main container if you're running additional sidekiq instances. It will run the `default` queue.	optional
SIDEKIQ_THREADS=5	The number of threads for sidekiq to use. See [notes](https://docs.joinmastodon.org/admin/scaling/#sidekiq-threads).	optional
DB_POOL=5	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).	optional
NO_CHOWN=	Set to `true` to skip chown of /config on init. READ THE APPLICATION NOTES BEFORE SETTING THIS.	optional
MASTODON_PROMETHEUS_EXPORTER_ENABLED=	If set to `true`, Mastodon’s Ruby processes (web & Sidekiq) will enable the Prometheus instrumentation.	optional

Volumes
Path	Function	Required
/config	Contains all relevant configuration files.	required

Architectures

Pulling :latest picks the right one for your host automatically.

x86_64amd64-latest
arm64arm64v8-latest

Changelog

5 Jul 2026
Rebase to Alpine 3.24.
21 Oct 2025
Add prometheus exporter support.
20 Oct 2025
Add vips-heif.

Browse all

ferdium

v7.2.3-ls164

Ferdium is a desktop app that helps you organize how you use your favourite apps by combining them into one application.

7.2K13arm64

Quick start

Parameters

Architectures

Tags

Changelog

Similar images

ferdium