📖 Tutorial P Postiz

Postiz Workflow — A Step-by-Step Tutorial

Self-host Postiz with Docker, connect 5 social platforms, schedule a week of content in one sitting, and use AI to generate captions — all without paying a SaaS subscription.

90 min
Est. Time
Intermediate
Difficulty
Free (self-hosted)
Cost
CreatorStack Team
Author

Postiz Workflow — A Step-by-Step Tutorial

Postiz is an open-source social media management platform you can self-host. This tutorial walks you through deploying it with Docker, connecting your social accounts, scheduling a week of content, and using the built-in AI caption generator. By the end, you’ll have a self-hosted Buffer replacement that costs nothing but server time.

Step 1: Deploy Postiz with Docker

You need a server (VPS or local machine) with Docker and Docker Compose installed.

  1. Create a project directory and download the compose file:
mkdir postiz && cd postiz
curl -o docker-compose.yml https://raw.githubusercontent.com/gitroomhq/postiz-app/main/docker-compose.yml
  1. Create the config file from the template:
curl -o config.toml https://raw.githubusercontent.com/gitroomhq/postiz-app/main/config.toml
  1. Generate a secret key and edit the config:
openssl rand -hex 32

Open config.toml and set:

  • jwt_secret = the generated key
  • database_url = keep the default (uses the bundled PostgreSQL container)
  • base_url = your server’s IP or domain (e.g., http://YOUR_SERVER_IP:4200)
  1. Start the stack:
docker compose up -d
  1. Wait 30 seconds, then visit http://YOUR_SERVER_IP:4200 in your browser. You should see the Postiz login screen.

  2. Create your admin account (first user becomes admin automatically).

Pro tip: For production, put Postiz behind a reverse proxy (Caddy or nginx) with HTTPS. Caddy is the easiest — it auto-provisions Let’s Encrypt certificates. Add a domain pointing to your server, run Caddy, and proxy requests to port 4200.

Step 2: Connect Your Social Accounts

Postiz supports Instagram, TikTok, X (Twitter), LinkedIn, YouTube, Pinterest, Reddit, Threads, and Dribbble.

  1. Go to Settings → Social Accounts
  2. Click Connect next to each platform you use
  3. You’ll be redirected to the platform’s OAuth flow — log in and authorize Postiz
  4. Repeat for each platform

For Instagram, you need a Business or Creator account (personal accounts don’t support third-party posting). Switch in Instagram Settings → Account Type and Tools → Switch to Professional Account.

Pro tip: Connect at least 3 platforms. The value of Postiz is cross-posting — writing once and publishing everywhere. With 1-2 platforms, manual posting is faster.

Step 3: Set Up AI Content Generation

Postiz includes built-in AI for caption writing and post ideation. You need an API key from an LLM provider.

  1. Go to Settings → AI Configuration
  2. Choose your provider:
    • OpenAI (GPT-4o) — best quality, costs per request
    • Anthropic (Claude) — strong writing, costs per request
    • Ollama (self-hosted) — free but requires a local LLM server
  3. Paste your API key
  4. Set the default tone: pick “Professional”, “Casual”, or “Witty”
  5. Set your brand description (2-3 sentences about what you do) — this becomes context for all AI generations

Pro tip: If you self-host an Ollama instance alongside Postiz (same Docker network), you get unlimited AI captions for free. Run ollama serve and point Postiz to http://ollama:11434. Use the llama3 or qwen2 model.

Step 4: Schedule a Week of Content

Now the real workflow — plan 7 days of posts across multiple platforms in one session:

  1. Go to Calendar → you’ll see a week view with connected platforms as rows
  2. Click any empty slot to create a post
  3. Write your caption (or click AI Generate and type a topic — Postiz writes the caption for you)
  4. Add media: drag an image or video into the post composer
  5. Select which platforms to publish to (you can customize the caption per platform)
  6. Set the date and time
  7. Click Schedule

Repeat for each day. A realistic batch session:

  • Monday: New blog post announcement → all platforms
  • Tuesday: Behind-the-scenes photo → Instagram + TikTok
  • Wednesday: Tip thread → X + LinkedIn
  • Thursday: YouTube video link → all platforms
  • Friday: Quote or stat graphic → Instagram + Pinterest
  • Saturday: Community question → X + LinkedIn
  • Sunday: Week recap carousel → Instagram + TikTok

Pro tip: Schedule posts at platform-specific peak times. Postiz shows recommended times based on your audience analytics after 2 weeks of data collection. Before that, use these defaults: Instagram 11am/7pm, TikTok 12pm/7pm, X 8am/3pm, LinkedIn 8am/10am (all in your audience’s timezone).

Step 5: Use the Unified Inbox

Postiz pulls comments and DMs from all connected platforms into one stream:

  1. Go to Inbox in the left sidebar
  2. Filter by platform or show all
  3. Click any message to reply directly from Postiz — your response posts to the original platform
  4. Mark messages as resolved to keep the queue clean

This eliminates the daily ritual of opening Instagram, TikTok, X, and LinkedIn separately to check comments. Spend 15 minutes in the inbox each morning instead.

Pro tip: Use the AI reply suggestion button for common questions (pricing, links, hours). Review and edit before sending — AI replies can feel generic if sent verbatim.

Step 6: Review Analytics

After 1-2 weeks of scheduled posts, Postiz starts showing performance data:

  1. Go to Analytics → Overview
  2. See total posts published, engagement rate, follower growth, and best-performing content
  3. Filter by platform to compare performance across channels
  4. Identify your top 3 posts — note the format, topic, and posting time

Use this data to adjust next week’s calendar. If LinkedIn posts get 5x the engagement of Instagram posts, shift your effort accordingly.

Pro tip: Postiz analytics are basic compared to native platform tools. For deep dives, use each platform’s built-in analytics (TikTok Creator Studio, Instagram Insights). Postiz is for scheduling and cross-posting efficiency, not deep analytics.

Recap

You deployed Postiz via Docker, connected your social accounts, configured AI caption generation, scheduled a full week of multi-platform content, and set up a unified inbox for comment management. Your total cost: server hosting (a $5/mo VPS is plenty). Compare that to Buffer’s $6/mo Starter plan or Hootsuite’s $99/mo Professional plan — Postiz gives you more features for less, at the cost of initial setup time.