Postfalcon: a lightweight self-hosted social media scheduler (AGPL, one-command Docker install)
retained text
Hey everyone, I've been building a social media scheduler that is fast and easy to run yourself. I know there are a bunch of these things already but I wanted one that worked on a machine with tight hardware resources, so like limited CPU/RAM (so I could run it on a cheap VPS or small arm board like silent lower powered device) and it's at a point where it would be cool to get some feedback from other people who host things. It's pretty self explanatory, you write a post once, put it on a calendar, and it publishes on time to Mastodon, Bluesky, Telegram, Facebook, Instagram, Threads, YouTube, TikTok, Pinterest and LinkedIn. You can cross-post to several channels at once, set up recurring posts, and see basic analytics (just like views, likes, comments and shares) from the platforms that report them. There's also a REST API, an MCP server and outbound webhooks if you want to script it. [The calendar: scheduled and published posts across channels \(demo data\)](https://preview.redd.it/ezn5mfqsfj1i1.png?width=1440&format=png&auto=webp&s=f41b4ae50c138bc1df89202e6b082a14ce5bef67) [Writing one post for several channels at once](https://preview.redd.it/182kff1xfj1i1.png?width=1440&format=png&auto=webp&s=6149c4bf45aec514ad74740d0370c8b1e7615168) The app runs in 3 containers, the app, Postgres 16 and Caddy (automatic HTTPS). The app uses about 100MB of RAM at rest, so a 1GB or maybe even a 512MB VPS should be more than enough and it has images for amd64 and arm64. One-line install: `curl -fsSL` [`https://postfalcon.co/install.sh`](https://postfalcon.co/install.sh) `| sh`. It checks for Docker, asks for your domain, generates the secrets and starts everything in `~/postfalcon.` You can read the script first; the README shows how. If you'd rather build it yourself, plain docker compose from source works too. After install you shouldn't need to SSH in or touch SQL. The first account becomes the admin. From the web UI you can then: * set sign-ups to open, invite-only (with one-time links) or closed * choose which platforms are offered * see setup checks, an update check and a server error log * manage nightly pg\_dump backups (list, download, back up now; optional copy to S3) * get email alerts when posts fail, the scheduler stops or backups go stale Mastodon, Bluesky and Telegram work straight away. The other platforms need your own developer app keys from each platform as that's how their APIs work, and some require an app review which takes ages. I've been making sites as a hobby using Node/Express/MySQL for years before vibe coding was a thing. So to keep Postfalcon lean and the code I am kind of comfortable with, it's built on Node/Express, Postgres, server-rendered pages and vanilla JS, with no frontend framework or build step. I wrote it with heaps of help from Claude Code since it doesn't make sense to code it all manually anymore, but wanted to keep it using technologies that I still understand pretty well. The test suite runs against a real Postgres database, and the conventions are documented in the repo. [ Platforms admin: switch platforms on or off and see which keys are missing](https://preview.redd.it/9ezovuj5gj1i1.png?width=1440&format=png&auto=webp&s=a5b79b821ad38ebb3ccd450df03eb04fa3343e19) GitHub: [https://github.com/postfalcon/postfalcon](https://github.com/postfalcon/postfalcon) License: AGPL-3.0 It's v1.0.0. It would be cool and helpful to hear if you get stuck with the install or if anything doesn't work as you expect it to.
document fetched 2026-11-15 00:27 · canonical https://reddit.com/r/selfhosted/comments/1xw25ir/postfalcon_a_lightweight_selfhosted_social_media