Self-Hosting Docs

Use these docs when you run OpenPost on your own server. They cover setup, web addresses, secrets, social network apps, backups, and updates.

These pages assume that you manage the server. You should know how to set environment variables, save data outside a container, run a reverse proxy, and make backups.

Install

• Why Self-Host? explains the costs and benefits. OpenPost uses SQLite and local files by default when you run it yourself.
• Docker Compose is the best place to start.
• Single Binary covers the app and server in one file.
• Nix Module covers the generated NixOS module reference.
• Reverse Proxy covers public HTTPS routing.
• Build From Source covers local builds.
• Docker Run shows how to run the container by hand.

Configure

• Configuration Overview groups the main settings.
• Environment Variables is the full configuration reference.
• Database covers SQLite and Postgres.
• Media Storage covers local files and S3/R2 storage.
• CORS and URLs covers public app and media web addresses.
• Production Checklist helps you check the server before people use it.

Providers

• Providers Overview explains social network app setup.
• Supported Platforms and Limits lists current implementation state.
• Provider Troubleshooting helps with OAuth, access, media link, and publish errors.
• Provider Roadmap explains what works now and what is planned.
• X, Mastodon, Bluesky, LinkedIn, Threads, Facebook, Instagram, TikTok, YouTube, and Discord cover each network's setup.

Operate

• Backups
• Health Checks
• Logs
• Upgrades
• Troubleshooting

Adjacent docs

• If you only need to use the product, start with User Docs.
• If you are changing OpenPost code, start with Developer Docs.