Bongsu guides
Guides for people who run Bongsu: install it, connect your accounts, use it, give agents access.
| Page | What it covers |
|---|---|
| Get started | |
| What is Bongsu | What Bongsu does and the main ideas: plan items, approval, drafts, comments |
| How it works | Approval, the schedule, how a post goes out, drafts, notifications, results |
| Install | |
| Deploy on Cloudflare | From an empty Cloudflare account to a running instance |
| Self-hosting with Docker | One container on your own server: settings, HTTPS with Caddy, email, updates, backups |
| Connect your accounts | |
| Creating the Meta app, the token, connecting an account, renewals | |
| Instagram through Composio | The other way to post to Instagram, and its Trial Reels limit |
| YouTube | The OAuth client and refresh token per channel, for the Shorts comments |
| Google Drive | Connecting your Drive as a media store, the folders, uploads from the app |
| S3-compatible buckets | AWS S3, R2, B2 or MinIO as a media store: the key, the CORS rule, the folders |
| Use Bongsu | |
| The phone app | Installing it, Today, approving, holding, pausing, notifications, comments |
| Captions and checks | The texts of a post, what the caption check catches, what blocks approval |
| The dashboard | Connections, accounts, devices and passkeys, keys and tokens, settings |
| Agents | |
| Connect Claude | Create a key, add Bongsu to Claude Code, a first plan, other MCP clients |
| What agents can do | Scopes, what an agent never does, why a change needs approval, times, limits |
| API reference | Keys and scopes, MCP, the tools and REST endpoints |
| The command line | The bongsu command: login, queue, texts, approve, export, MCP bridge, secrets |
| Reference | |
| Configuration | Accounts, variables, secrets, tunable limits |
| Security | Passkeys, approvals, keys, signed media links |
| Platform terms | Official APIs only, rate limits, no scraping, your responsibility |
| Updating | Updating on Cloudflare and Docker, reading the changelogs, breaking changes |
| Backups and restore | D1, SQLite and Postgres backups, the media, restoring, what a backup doesn't hold |
| Changelog | What changed in each release, the packages it published and their versions |
| FAQ and troubleshooting | A post that didn't go out, expired tokens, limits, missing media, time zones, passkeys |