Skip to main content

Self-Host Postiz: Open Source Social Scheduler 2026

·OSSAlt Team
self-hostingsocial-mediadockerpostizopen-source
Share:

Self-Host Postiz: Open Source Social Scheduler 2026

TL;DR

Postiz is the best free, self-hosted alternative to Buffer and Hootsuite in 2026. It supports 17+ social platforms, includes an AI writing assistant, and runs on a $6/month VPS with a single docker compose up command. If you're paying $18–$100/month for social scheduling, self-hosting Postiz eliminates that cost permanently.

Key Takeaways

  • 14,000+ GitHub stars since launching in September 2024 — one of the fastest-growing self-hosted tools of 2025
  • 17+ platforms supported: X, LinkedIn, Instagram, Facebook, TikTok, YouTube, Reddit, Threads, Mastodon, Bluesky, and more
  • AI writing assistant included — generates post ideas, writes copy, and suggests optimal posting times
  • Minimum requirements: 2 vCPUs, 2 GB RAM (a $6/month Hetzner or DigitalOcean VPS works fine)
  • Stack: Node.js app + PostgreSQL 17 + Redis 7 + optional Temporal for workflow orchestration
  • License: AGPL-3 — fully open source, self-hosted instances have no restrictions

Why Postiz Is Worth Self-Hosting in 2026

Buffer costs $18–$100/month per workspace. Hootsuite starts at $99/month. Later starts at $25/month. For indie hackers, agencies, or anyone managing multiple social accounts, these costs add up fast.

Postiz launched in September 2024 as a full open-source alternative and hit 14,000 GitHub stars in under 18 months — a growth rate that rivals tools like Umami and Plausible. By March 2026, it supports every major platform, has a polished UI that competes directly with the paid tools, and runs reliably on modest hardware.

What makes Postiz stand out from earlier open-source scheduling tools:

  1. Canva-like image editor built into the composer — design graphics without leaving the app
  2. AI assistant that writes post copy and suggests hashtags (requires your own OpenAI API key)
  3. Team collaboration — multiple users, approval workflows, and role-based access
  4. Analytics dashboard — track engagement, clicks, and follower growth across platforms
  5. Calendar view — drag-and-drop content planning across all platforms in a single view

The self-hosted version has no feature limits compared to the paid cloud. You get unlimited channels, unlimited posts, and unlimited team members — your only cost is infrastructure.


Requirements

Before you start, make sure you have:

  • A VPS or server with 2 vCPUs and 2 GB RAM minimum (Ubuntu 22.04 or 24.04 recommended)
  • Docker and Docker Compose installed
  • A domain name pointed at your server (Postiz requires HTTPS for secure cookies)
  • API credentials from the social platforms you want to connect (obtained from each platform's developer portal)

Postiz's architecture runs four containers:

ContainerPurpose
postiz-appMain Node.js application
postiz-postgresPostgreSQL 17 database
postiz-redisRedis 7 cache
postiz-temporal(Optional) Durable workflow engine for scheduled posts

Docker Compose Setup

Step 1: Create the project directory

mkdir /opt/postiz && cd /opt/postiz

Step 2: Create your .env file

cat > .env << 'EOF'
# Application URLs (replace with your domain)
MAIN_URL=https://postiz.yourdomain.com
FRONTEND_URL=https://postiz.yourdomain.com

# Authentication — generate a strong random string
JWT_SECRET=your-super-secret-jwt-key-here

# Database
DATABASE_URL=postgresql://postiz-user:postiz-password@postiz-postgres:5432/postiz-db

# Redis
REDIS_URL=redis://postiz-redis:6379

# Storage — use "local" for filesystem storage
STORAGE_PROVIDER=local
UPLOAD_DIRECTORY=/uploads

# Email (optional — for invites and notifications)
EMAIL_PROVIDER=smtp
SMTP_HOST=smtp.yourdomain.com
SMTP_PORT=587
SMTP_USER=noreply@yourdomain.com
SMTP_PASS=your-email-password

# AI Features (optional — for the AI writing assistant)
OPENAI_API_KEY=sk-your-openai-key
EOF

Step 3: Create the Docker Compose file

# docker-compose.yml
version: "3.8"

services:
  postiz-postgres:
    image: postgres:17-alpine
    container_name: postiz-postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: postiz-user
      POSTGRES_PASSWORD: postiz-password
      POSTGRES_DB: postiz-db
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postiz-user -d postiz-db"]
      interval: 10s
      timeout: 5s
      retries: 5

  postiz-redis:
    image: redis:7.2-alpine
    container_name: postiz-redis
    restart: unless-stopped
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

  postiz-app:
    image: ghcr.io/gitroomhq/postiz-app:latest
    container_name: postiz-app
    restart: unless-stopped
    env_file: .env
    ports:
      - "3000:3000"
    volumes:
      - uploads:/uploads
    depends_on:
      postiz-postgres:
        condition: service_healthy
      postiz-redis:
        condition: service_healthy

volumes:
  postgres-data:
  redis-data:
  uploads:

Step 4: Start Postiz

docker compose pull
docker compose up -d

Postiz will be available at http://your-server-ip:3000. Open it in your browser to complete the setup wizard, create your admin account, and connect your social platforms.

Step 5: Set up a reverse proxy with HTTPS

Postiz requires HTTPS (secure cookies). Use Caddy for the simplest SSL setup:

# Install Caddy
apt install -y caddy

# /etc/caddy/Caddyfile
postiz.yourdomain.com {
    reverse_proxy localhost:3000
}

systemctl restart caddy

Caddy automatically provisions and renews Let's Encrypt certificates.


Connecting Social Platforms

Each platform requires creating a developer app to get API credentials. The process varies by platform:

X (Twitter): Apply for a developer account at developer.x.com → Create a project → Set callback URL to https://postiz.yourdomain.com/oauth/twitter/callback

LinkedIn: Go to linkedin.com/developers → Create an app → Add r_liteprofile, r_emailaddress, w_member_social scopes

Instagram: Requires a Facebook Developer account → Instagram Basic Display API → Add callback URL

Mastodon / Bluesky: No API key needed — Postiz uses username/password authentication directly

Once you have credentials for each platform, add them in Settings → Providers inside Postiz.


Postiz vs Paid Alternatives

FeaturePostiz (Self-Hosted)Buffer Pro ($18/mo)Hootsuite ($99/mo)
Platforms17+835+
Monthly cost~$6 (VPS)$18$99
Team membersUnlimited15
AI writing assistant✅ (OpenAI key)
Image editor
Analytics
Self-hosted
Data ownershipFullNoNo

For most indie hackers and small agencies, Postiz on a $6/month Hetzner CX22 instance matches Buffer Pro at a fraction of the price. Hootsuite's enterprise integrations are more comprehensive, but Postiz covers the 80% case.


Common Gotchas

HTTPS is mandatory: Postiz uses secure cookies, which require HTTPS. Don't try to run it over plain HTTP — you'll get auth errors.

Platform API rate limits: X's free tier API has strict posting limits (1,500 tweets/month). Postiz respects these limits, but if you're managing high-volume accounts, you'll need an elevated X API tier.

PostgreSQL backups: Run daily backups with docker exec postiz-postgres pg_dump -U postiz-user postiz-db > backup.sql. Add this to a cron job.

Image storage: By default, Postiz stores uploaded images on the local filesystem. For production, configure Cloudflare R2 or S3 via the STORAGE_PROVIDER environment variable to avoid losing images when the container restarts.


Recommendations

Use Postiz self-hosted if:

  • You manage 3+ social accounts and are paying $15–$100/month for scheduling tools
  • You want complete data ownership and no vendor lock-in
  • You're comfortable with basic Docker administration

Stick with a paid service if:

  • You need Hootsuite's 35+ platform integrations or advanced compliance features
  • You can't maintain a VPS (no ops experience on your team)
  • You need SLA-backed uptime guarantees

Methodology

  • Sources: Postiz GitHub (14k stars, Sept 2024 launch), official docs at docs.postiz.com, Railway deployment guide (updated Feb 2026), BabaBuilds community self-hosting guide
  • Hardware tested: 2 vCPU / 2 GB RAM VPS
  • Date: March 2026

Scheduling social media is only part of the stack. See our roundup of best open source scheduling tools 2026 and best open source email marketing tools 2026 for the full picture.

Also on OSSAlt: How to self-host Mastodon — own your social presence end-to-end.

Comments

The SaaS-to-Self-Hosted Migration Guide (Free PDF)

Step-by-step: infrastructure setup, data migration, backups, and security for 15+ common SaaS replacements. Used by 300+ developers.

Join 300+ self-hosters. Unsubscribe in one click.