{"id":21270713,"url":"https://github.com/explodingcamera/docker-pleroma","last_synced_at":"2025-07-11T05:32:18.666Z","repository":{"id":129697092,"uuid":"579747437","full_name":"explodingcamera/docker-pleroma","owner":"explodingcamera","description":"a simple and compact docker image for pleroma","archived":false,"fork":false,"pushed_at":"2024-01-04T00:48:56.000Z","size":46,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-11T06:48:48.058Z","etag":null,"topics":["docker","fediverse","mastodon","pleroma"],"latest_commit_sha":null,"homepage":"","language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/explodingcamera.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-12-18T19:32:03.000Z","updated_at":"2024-03-17T23:27:10.000Z","dependencies_parsed_at":"2023-12-17T11:38:24.656Z","dependency_job_id":"86d40ee8-5a9a-49f8-b6cd-d1a8d50f9876","html_url":"https://github.com/explodingcamera/docker-pleroma","commit_stats":{"total_commits":26,"total_committers":1,"mean_commits":26.0,"dds":0.0,"last_synced_commit":"3be94d30d0402e0c86cec86238b6eb0bdc71ef1f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/explodingcamera%2Fdocker-pleroma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/explodingcamera%2Fdocker-pleroma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/explodingcamera%2Fdocker-pleroma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/explodingcamera%2Fdocker-pleroma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/explodingcamera","download_url":"https://codeload.github.com/explodingcamera/docker-pleroma/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224986421,"owners_count":17402936,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","fediverse","mastodon","pleroma"],"created_at":"2024-11-21T08:18:23.686Z","updated_at":"2025-07-11T05:32:18.659Z","avatar_url":"https://github.com/explodingcamera.png","language":"Elixir","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pleroma Docker\n\nSimple Docker image for [Pleroma](https://pleroma.social/).\nCurrently, only x86_64 is supported. If you want to run Pleroma on other architectures, you should be able to build it yourself using the Dockerfile. I don't run a Pleroma instance myself anymore so there might be some issues with the image whenever a new pleroma version is released.\n\n# Supported tags\n\n- [`latest`](https://github.com/explodingcamera/docker-pleroma/pkgs/container/pleroma) - latest stable release\n- [`3`](https://github.com/explodingcamera/docker-pleroma/pkgs/container/pleroma) - latest 3.x release\n- [`3.15`](https://github.com/explodingcamera/docker-pleroma/pkgs/container/pleroma) - specific minor version\n- [`3.15.1`](https://github.com/explodingcamera/docker-pleroma/pkgs/container/pleroma) - specific version\n- [`develop`](https://github.com/explodingcamera/docker-pleroma/pkgs/container/pleroma) - latest develop branch build\n\nVersions are build automatically using GitHub Actions weekly.\n\n# How to use this image\n\n## Start a Pleroma instance\n\n**Docker Compose**\n\n```yaml\nversion: \"3.8\"\n\nservices:\n  db:\n    image: postgres:17-alpine\n    container_name: pleroma_db\n    restart: always\n    healthcheck:\n      test: [\"CMD\", \"pg_isready\", \"-U\", \"pleroma\"]\n    environment:\n      POSTGRES_USER: pleroma\n      POSTGRES_PASSWORD: ChangeMe!\n      POSTGRES_DB: pleroma\n    volumes:\n      - ./data/postgres:/var/lib/postgresql/data\n  web:\n    image: ghcr.io/explodingcamera/pleroma:stable\n    container_name: pleroma_web\n    healthcheck:\n      test:\n        [\"CMD-SHELL\", \"wget -q --spider --proxy=off localhost:4000 || exit 1\"]\n    restart: always\n    ports:\n      - \"4000:4000\"\n    volumes:\n      - ./data/uploads:/data/uploads\n      - ./data/static:/data/static\n      - ./custom-config.exs:/data/config.exs\n    environment:\n      PUID: 1000\n      PGID: 1000\n      DOMAIN: example.com\n      INSTANCE_NAME: Pleroma\n      ADMIN_EMAIL: admin@example.com\n      NOTIFY_EMAIL: notify@example.com\n      DB_USER: pleroma\n      DB_PASS: ChangeMe!\n      DB_NAME: pleroma\n    depends_on:\n      - db\n```\n\n**Docker CLI**\n\n```bash\ndocker run -d \\\n  --name=pleroma \\\n  -e PUID=1000 \\\n  -e PGID=1000 \\\n  -e DOMAIN=\"example.com\"\n  -e INSTANCE_NAME=\"Pleroma\"\n  -e ADMIN_EMAIL=\"admin@example.com\"\n  -e NOTIFY_EMAIL=\"notify@example.com\"\n  -e DB_USER=\"pleroma\"\n  -e DB_PASS=\"ChangeMe!\"\n  -e DB_NAME=\"pleroma\"\n  -p 4000:4000 \\\n  -v /path/to/static:/data/static \\\n  -v /path/to/uploads:/data/uploads \\\n  -v /path/to/customconfig:/data/config.exs \\ # optional\n  --restart unless-stopped \\\n  ghcr.io/explodingcamera/pleroma:stable\n```\n\n# Running Commands\n\n```bash\n$ docker exec -it pleroma_web ./cli.sh user new \u003cusername\u003e \u003cyour@emailaddress\u003e --admin\n```\n\n# Configuration\n\n## Environment variables\n\n- `PUID` - User ID (default: `1000`)\n- `PGID` - Group ID (default: `1000`)\n- `DOMAIN` - Domain name (default: `example.com`)\n\n## Pleroma configuration\n\nSee [Pleroma documentation](https://docs.pleroma.social/backend/configuration/auth/) for more information.\n\n`custom-config.exs`\n\n```elixir\nimport Config\n\nconfig :pleroma, :instance,\n  registrations_open: false\n\nconfig :pleroma, Pleroma.Web.Endpoint,\n  url: [host: \"pleroma.example.org\"]\n\nconfig :pleroma, Pleroma.Web.WebFinger, domain: \"example.org\"\n```\n\n# Build-time variables\n\n- `PLEROMA_VERSION` - Pleroma version to build (default: `stable`)\n- `PLEROMA_REPO` - Pleroma repository to clone (default: `https://git.pleroma.social/pleroma/pleroma.git`)\n- `EXTRA_PKGS` - Extra packages to install (default: `imagemagick libmagic ffmpeg`)\n\n# Other Docker images\n\n- [angristan/docker-pleroma](https://github.com/angristan/docker-pleroma)\n- [potproject/docker-pleroma](https://github.com/potproject/docker-pleroma)\n- [rysiek/docker-pleroma](https://git.pleroma.social/rysiek/docker-pleroma)\n- [RX14/iscute.moe](https://github.com/RX14/kurisu.rx14.co.uk/blob/master/services/iscute.moe/pleroma/Dockerfile)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexplodingcamera%2Fdocker-pleroma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexplodingcamera%2Fdocker-pleroma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexplodingcamera%2Fdocker-pleroma/lists"}