The open-source, AI-native social media scheduling platform.
Self-hosted, bring-your-own-key AI across 25+ providers, 36+ channels, and 46 built-in media tools — an open-source alternative to Buffer, Hootsuite, and Sprout Social. Postmill is built for agencies, teams, and multi-brand operators who want to schedule everywhere, generate on-brand content with their own AI keys, and own their entire stack.
Website · Docs · Quick Start · Node SDK (@postmill-ai/postmill-sdk) · Public API
Screenshots and a product demo video are coming soon. In the meantime, explore the full feature tour in the documentation.
Postmill is AI-native from the ground up. A single governed AI layer powers every surface, and you bring your own keys: 25 providers — 13 direct model providers plus 12 multi-model hubs and gateways — configured per organization, with no bundled credits, quotas, or metering. Pick the exact model from an admin screen and switch providers everywhere without a redeploy.
On top of that: brand-voice profiles, a shared prompt library, retrieval-augmented (RAG) search over your own content, compliance guardrails (prompt-injection / PII / brand-safety / NSFW), per-org spend caps with a full audit log, and an agent/MCP automation surface. Every AI entry point is scoped, rate-limited, and budget-checked — and a deployment's environment key is never silently billed to a tenant.
Create everything in-app without leaving Postmill. The media suite is 46 tools: the Designer (a Konva canvas plus a full video timeline), the AI Designer, 38 BYOK provider studios spanning image, video, audio, avatar, and music generation, and 6 stock browsers for photos, videos, vectors, stickers, audio, and icons. Every generated or sourced asset lands in your media library, ready to attach to a post.
Schedule and publish across 36+ social, chat, blogging, and email channels from a single composer. Native support for polls, first-comment automation, threads, per-channel settings, and channel-aware previews means each platform gets exactly what it expects — from a single write.
Metrics are snapshotted daily and persisted, so you get real period-over-period trends instead of one-off live fetches. Drill into any channel, metric, or date range; see best-time-to-post heatmaps, prioritized recommendations, anomaly alerts, and a competitor watchlist — all normalized into a consistent cross-provider metric set.
Every reply on everything you publish, synced into one inbox. Reply, like, assign to teammates, draft responses with AI, filter by unread/status/sentiment, and bulk-mark-read — without bouncing between platforms.
Group posts, media, and channels into campaigns with automatic UTM tagging, draft approvals, goals, and KPIs. Share a read-only client report via a public link, and keep the team aligned with an internal discussion thread on each campaign.
Fine-grained role-based access control with 5 seeded roles (Owner / Admin / Editor / Member / Viewer) plus custom roles drawn from a 90-permission catalog (18 resources × 5 actions). Manage multiple brands per organization with per-post brand selection, session and refresh-token rotation with per-device revoke, and SSO via Google, GitHub, or generic OIDC.
Own your whole stack. Secrets are encrypted at rest (AES-GCM), all user-influenced outbound HTTP is SSRF-safe, and the app ships CSRF protection, Helmet, a strict CSP, and effective rate-limiting. Connect channels with your own per-tenant OAuth apps, bring your own object storage (S3 / R2 / Backblaze B2 / IDrive), swap in pluggable email and short-link providers, and optionally route outbound posting through per-channel VPN egress.
X · LinkedIn · LinkedIn Page · Reddit · Instagram Business · Instagram Standalone · Facebook Page · Threads · YouTube · Google My Business · TikTok · Pinterest · Dribbble · Discord · Slack · Kick · Twitch · Mastodon · Bluesky · Lemmy · Farcaster · Telegram · Nostr · VK · Medium · Dev.to · Hashnode · WordPress · ListMonk · Moltbook · Whop · Skool · MeWe · Tumblr · Pixelfed · PeerTube
git clone https://github.com/reaatech/postmill-app.git
cd postmill-app
pnpm install
cp .env.example .env # then fill in your values
docker compose -f docker-compose.dev.yaml up -d # postgres + redis
pnpm run dev:minimal # backend + frontendThe frontend runs on port 4200. For the full setup, configuration reference, and production deployment guide, see the documentation.
Postmill exposes a full Public API for programmatic scheduling, analytics, and channel management, an MCP surface for AI agents, and an official Node SDK — @postmill-ai/postmill-sdk. The Public API is compatible with low-code automation platforms such as n8n, Make, and Zapier, so you can wire Postmill into your existing workflows. See the API docs to get started.
- pnpm workspaces (monorepo)
- Next.js (React, App Router)
- NestJS
- Prisma + PostgreSQL
- Inngest (background jobs)
- Redis
- Pluggable email, storage, short-link, and AI providers
- Postmill is an open-source, self-hosted social media scheduling tool that supports platforms like X (formerly Twitter), Bluesky, Mastodon, Discord, and others.
- The Postmill hosted service uses official, platform-approved OAuth flows.
- Postmill does not automate or scrape content from social media platforms.
- Postmill users always authenticate directly with the social platform (e.g., X, Discord, etc.), ensuring platform compliance and data privacy.
Postmill began as a fork of Postiz, the open-source social scheduling tool created by Nevo David and the Gitroom team. Huge thanks to them for the foundation this project is built on. Postmill has since grown into its own standalone, AI-native platform, but the original work made it possible.
Postmill is created and maintained by REAA Technologies, a leader in open-source AI solutions, and is built on official @reaatech packages for its agentic foundations — including @reaatech/agent-mesh, @reaatech/guardrail-chain, @reaatech/hybrid-rag, @reaatech/agent-budget-*, and the @reaatech/media-pipeline-mcp-* suite.
This repository's source code is available under the AGPL-3.0 license.