# Postiz — Open Source Social Media Scheduling & Management

> Postiz is an open-source social media scheduling tool with AI content generation, multi-platform posting, team collaboration, and analytics — a Buffer/Hootsuite alternative.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

```bash
git clone https://github.com/gitroomhq/postiz-app.git
cd postiz-app
cp .env.example .env
docker compose up -d
```

Open `http://localhost:4200` — connect your social accounts and schedule your first post.

## Intro

**Postiz** is an open-source social media scheduling and management platform, serving as an alternative to Buffer, Hootsuite, and Later. Built with Next.js and NestJS, it provides multi-platform posting, AI-powered content generation, team collaboration, and analytics — all self-hosted with full data ownership.

With 28K+ GitHub stars and AGPL-3.0 license, Postiz has rapidly grown into one of the most popular open-source social media tools, enabling creators, marketers, and teams to manage their social presence without expensive SaaS subscriptions.

## What Postiz Does

Postiz covers the entire social media management workflow:

- **Multi-Platform Scheduling**: Schedule posts to Twitter/X, LinkedIn, Facebook, Instagram, TikTok, YouTube, Pinterest, Threads, Reddit, and Bluesky
- **AI Content Generation**: Generate post ideas, captions, and variations using AI (OpenAI, Claude, or local models)
- **Visual Calendar**: Drag-and-drop calendar view for planning content across platforms
- **Media Management**: Upload, crop, and manage images and videos with platform-specific previews
- **Team Collaboration**: Multi-user workspace with roles, approvals, and content assignment
- **Analytics Dashboard**: Track engagement, reach, clicks, and growth across all connected accounts
- **Auto-Scheduling**: AI-powered optimal timing suggestions based on audience activity

## Architecture

```
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Next.js     │────▶│  NestJS      │────▶│  PostgreSQL  │
│  Frontend    │     │  API + Queue │     │  (Prisma)    │
└──────────────┘     └──────┬───────┘     └──────────────┘
                            │
                  ┌─────────┼─────────┐
                  │         │         │
           ┌──────┴──┐ ┌───┴───┐ ┌───┴───┐
           │  Redis   │ │  AI   │ │ Social│
           │  (Queue) │ │ APIs  │ │ APIs  │
           └──────────┘ └───────┘ └───────┘
```

## Self-Hosting

### Docker Compose

```yaml
services:
  postiz:
    image: ghcr.io/gitroomhq/postiz-app:latest
    ports:
      - "4200:4200"   # Frontend
      - "3000:3000"   # Backend API
    environment:
      DATABASE_URL: postgresql://postiz:postiz@db:5432/postiz
      REDIS_URL: redis://redis:6379
      JWT_SECRET: your-jwt-secret
      FRONTEND_URL: http://localhost:4200
      BACKEND_INTERNAL_URL: http://localhost:3000
      # Social platform OAuth credentials
      TWITTER_CLIENT_ID: your-twitter-client-id
      TWITTER_CLIENT_SECRET: your-twitter-client-secret
    depends_on:
      - db
      - redis

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: postiz
      POSTGRES_PASSWORD: postiz
      POSTGRES_DB: postiz
    volumes:
      - pg-data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine

volumes:
  pg-data:
```

## Key Features

### Visual Content Calendar

The calendar provides a bird's-eye view of your content schedule:
- Drag-and-drop to reschedule posts
- Color-coded by platform
- Filter by account, platform, or team member
- Week, month, and list views

### AI Content Assistant

```
Input:  "Write a LinkedIn post about our new product launch"
Output: "🚀 Excited to announce [Product Name]!

After months of development, we're launching a tool that...

Key features:
✅ Feature 1
✅ Feature 2
✅ Feature 3

Early access is now open → [link]

#ProductLaunch #SaaS #Startup"
```

The AI assistant can:
- Generate posts from scratch based on topics or keywords
- Rewrite existing content for different platforms
- Create variations for A/B testing
- Suggest hashtags and emojis

### Supported Platforms

| Platform | Post | Schedule | Analytics | Media |
|----------|------|----------|-----------|-------|
| Twitter/X | ✅ | ✅ | ✅ | Images, GIFs |
| LinkedIn | ✅ | ✅ | ✅ | Images, Videos |
| Facebook | ✅ | ✅ | ✅ | Images, Videos |
| Instagram | ✅ | ✅ | ✅ | Images, Reels |
| TikTok | ✅ | ✅ | ✅ | Videos |
| YouTube | ✅ | ✅ | ✅ | Videos |
| Reddit | ✅ | ✅ | Basic | Images |
| Bluesky | ✅ | ✅ | Basic | Images |

## Postiz vs Alternatives

| Feature | Postiz | Buffer | Hootsuite | Later |
|---------|--------|--------|-----------|-------|
| Open Source | Yes (AGPL-3.0) | No | No | No |
| Self-hosted | Yes | No | No | No |
| AI generation | Built-in | Add-on | Add-on | Limited |
| Platforms | 10+ | 8 | 10+ | 7 |
| Team collab | Yes | Paid plans | Paid plans | Paid plans |
| Pricing | Free (self-host) | $6/mo/channel | $99/mo | $25/mo |

## FAQ

**Q: Which social platform API keys do I need?**
A: Each platform requires its own OAuth app credentials. Register apps on the Twitter Developer Portal, LinkedIn Developer, Facebook Developer, etc., and obtain Client ID and Secret.

**Q: Do AI features require an OpenAI API key?**
A: Yes — AI content generation requires an OpenAI API key (or compatible API). Local models via Ollama are also supported. You can still use scheduling and publishing without an AI key.

**Q: How many social accounts can I manage?**
A: The self-hosted version has no account limit. You can connect any number of social accounts — great for agencies and multi-brand management.

## Source & Thanks

- GitHub: [gitroomhq/postiz-app](https://github.com/gitroomhq/postiz-app) — 28K+ ⭐ | AGPL-3.0
- Website: [postiz.com](https://postiz.com)

---
Source: https://tokrepo.com/en/workflows/postiz-open-source-social-media-scheduling-management-d528c69b
Author: AI Open Source