Skip to content

Pubky Docker

Pubky Docker runs a full local Pubky environment, including Pubky Homeserver, Homegate, and the Pubky Social components Pubky Nexus and pubky.app.

For current setup instructions, configuration, and development workflows, see the Pubky Docker README.

Testnet Architecture

Section titled “Testnet Architecture”

The following simplified diagram shows the default local testnet topology. The DHT, PKARR relay, and HTTP relay run locally inside the homeserver service.

Build from Source

Section titled “Build from Source”

Build from source when you need to run specific component revisions or test changes to the stack.

Run pubky-docker-cli.sh from the root of a cloned Pubky Docker repository:

Terminal window
./pubky-docker-cli.sh

The script pulls the required repositories, lets you choose Git refs, builds the images, and starts the stack. To inspect the running versions, use list-component-versions.sh from the same directory:

Terminal window
./list-component-versions.sh

See the Pubky Docker source setup instructions for more details.

Section titled “Links”
Section titled “Related Documentation”