---
title: "Deploy BrightBean Studio"
description: "Self-hosted social media scheduler: web+worker, Postgres, media volume"
category: "Other"
url: https://railway.com/deploy/brightbean-studio-1
---

# Deploy BrightBean Studio

Self-hosted social media scheduler: web+worker, Postgres, media volume

**[Deploy BrightBean Studio on Railway](https://railway.com/template/brightbean-studio-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/brightbean-studio-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### BrightBean Studio https://raw.githubusercontent.com/brightbeanxyz/brightbean-studio/14b92fc18549de47d42e62054215b38b4d994449/static/favicon/apple-touch-icon.png

- **Source:** https://github.com/aalfath/brightbean-studio-railway-template
- **Health check:** /health/
- **Public domain:** Yes

## Documentation

# Deploy and Host BrightBean Studio on Railway

BrightBean Studio is an open-source, self-hostable social media management platform for creators, agencies and small businesses. You plan, compose, schedule, approve and publish posts, and watch comments and analytics, across Facebook, Instagram, LinkedIn, TikTok, YouTube, Pinterest, Threads, Bluesky, Google Business Profile, Mastodon and DEV.to, with no per-seat or per-channel limits.

## About Hosting BrightBean Studio

BrightBean Studio is a Django app with three parts: the web app, a background worker that publishes scheduled posts and syncs inboxes and analytics, and PostgreSQL. This template runs the web app and the worker together in one service, built from a pinned upstream commit. The worker then reads the same uploaded media, on a Railway volume at `/app/media`, so media posts publish without S3. Migrations run and the first admin is created on every start. Signup is invite-only by default. After deploying, sign in with `ADMIN_EMAIL` and the generated `ADMIN_PASSWORD`, then add your own developer credentials for each social platform you want to connect.

## Common Use Cases

* Schedule and auto-publish posts to several social networks from one calendar
* Run approval workflows with teammates and clients before posts go live
* Answer comments, mentions and messages from one shared inbox, and track post analytics

## Dependencies for BrightBean Studio Hosting

* PostgreSQL (included, Railway's managed Postgres)
* A Railway volume for uploaded images and videos (included)

### Deployment Dependencies

* [BrightBean Studio on GitHub](https://github.com/brightbeanxyz/brightbean-studio)
* [Pinned upstream commit 14b92fc](https://github.com/brightbeanxyz/brightbean-studio/commit/14b92fc18549de47d42e62054215b38b4d994449)
* [Template repository, variables and changelog](https://github.com/aalfath/brightbean-studio-railway-template)
* [Platform credential setup (upstream README)](https://github.com/brightbeanxyz/brightbean-studio#platform-credentials)

### Implementation Details

* **One prompt:** `ADMIN_EMAIL`. `ADMIN_PASSWORD`, `SECRET_KEY` and `ENCRYPTION_KEY_SALT` are generated. Copy `ADMIN_PASSWORD` from the service's Variables tab to sign in, then change it in the app. Never change `SECRET_KEY` or `ENCRYPTION_KEY_SALT` afterwards: they encrypt the stored platform tokens.
* **Defaults you can override with service variables:** `APP_URL` (the Railway domain; set it when you add a custom domain), `ALLOWED_HOSTS` (your domains, never `*`), `SIGNUP_MODE=invite` (`open` or `closed` also work).
* **Email:** without SMTP, emails such as invitations and password resets are written to the deploy logs. Set `EMAIL_HOST`, `EMAIL_PORT`, `EMAIL_HOST_USER`, `EMAIL_HOST_PASSWORD` and `DEFAULT_FROM_EMAIL` to send them for real.
* **Social platforms:** set `PLATFORM_*` variables (see upstream's `.env.example`), or enter credentials in `/admin/` → Credentials → Platform credentials. OAuth callbacks use `https://YOUR-DOMAIN/...`.
* **Updates:** the service builds from the template's GitHub repo. When we move to a newer upstream commit, Railway shows an "update available" notice and you choose when to apply it. Migrations run on start, and your data stays in Postgres and on the volume. Check the repo's CHANGELOG.md before you update.

## Why Deploy BrightBean Studio on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying BrightBean Studio on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/brightbean-studio-1
