The most common issues people run into when using Postiz, with concrete fixes. If your problem isn’t covered here, try the Discord or open an issue on GitHub.Documentation Index
Fetch the complete documentation index at: https://docs.postiz.com/llms.txt
Use this file to discover all available pages before exploring further.
Cloud users
Connecting a social channel
“Invalid state”, “invalid_grant”, “fetch failed” — what they mean and how to recover.
Uploads & media
Payload-too-large, upload-from-url timeouts, video failures, cancel-in-flight.
Activation & login
Expired activation links, “jwt malformed”, login API 404/204.
Billing
Stripe.js blocked, billing page broken in incognito, discount apply errors.
Channel limits
“You have reached the maximum number of channels”.
Known issues
Live tracker of bugs we’re aware of, with workarounds.
Self-hosted
Self-host gotchas
pnpm OOM, Postgres ECONNREFUSED, port confusion, hiding providers, Vercel.
System requirements
Minimum CPU/RAM, required services, default ports.
WebSockets & dev tunnels
HMR over ngrok, allowedDevOrigins, redirectmeto OAuth proxy.
Uploads & storage
Mounting UPLOAD_DIRECTORY, local vs Cloudflare R2.