A self contained Bluesky PDS
  • Dockerfile 51.8%
  • Shell 31.9%
  • Makefile 16.3%
Find a file
Nathan Price 6297c6d25d
All checks were successful
/ build-and-push-image (push) Successful in 1m25s
fix qemu setup order
2026-01-07 16:01:57 -05:00
.forgejo/workflows fix qemu setup order 2026-01-07 16:01:57 -05:00
.vscode I'm tired of making this in every local branch. 2025-05-21 15:57:33 -04:00
.dockerignore update ignores 2025-03-04 11:39:21 -05:00
.gitignore I'm tired of making this in every local branch. 2025-05-21 15:57:33 -04:00
docker-compose.yaml change volume name 2025-03-04 11:39:32 -05:00
Dockerfile automatically get the PDS version 2025-05-21 15:48:00 -04:00
entrypoint.sh run node as pds rather than switching user 2025-03-05 11:10:31 -05:00
example.env reorder variables 2025-05-20 14:25:44 -04:00
LICENSE change to dual license to match upstream PDS project 2025-05-20 14:10:13 -04:00
LICENSE-APACHE change to dual license to match upstream PDS project 2025-05-20 14:10:13 -04:00
LICENSE-MIT change to dual license to match upstream PDS project 2025-05-20 14:10:13 -04:00
Makefile add a generate-env target 2025-05-21 15:48:14 -04:00
README.md update version 2026-01-06 22:57:50 -05:00

bluesky-pds-docker

Official bluesky-pds project GitHub - bluesky-social/pds
Image on Forgejo Forgejo
Image on Dockerhub Dockerhub
Issue Tracker GitHub - gravityfargo/bluesky-pds-docker
Docs ModernLeft Docs

This project is adapted from

https://github.com/bluesky-social/pds/blob/v0.4.135/installer.sh
https://github.com/bluesky-social/pds/blob/v0.4.135/Dockerfile

Current Version: 0.4.193

Requirements

Arch

sudo pacman -S docker docker-compose docker-buildx

Building

# Generate the `.env` file from the `example.env` file.
make generate-env

# build the image
make build

The dockerfile gets the latest upstream pds version automatically, but the makefile tags the image to dev.

Testing

# Run the container
make run

You should get bluesky-pds-dev | {"level":30,"time":1745614550607,"pid":14,"hostname":"manjaro-desktop","name":"pds","msg":"pds has started"} or similar in the logs.

# You can verify it's running via the healthcheck endpoint
curl http://localhost:3000/xrpc/_health

You should get the latest version

{ "version": "0.4.136" }

Latest Version: 0.4.158