> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common PostQueen problems and how to resolve them

Something is not working. Start here. She is usually fine; the connection to a network usually is
not.

<Snippet file="report-it.mdx" />

## Cloud users

<CardGroup cols={2}>
  <Card title="A post did not go out" icon="triangle-exclamation" href="/troubleshooting/post-failed">
    Red card, stuck in the queue, or nothing on the platform: which state it is in and how to send it again.
  </Card>

  <Card title="Connecting a social channel" icon="link" href="/troubleshooting/oauth-connect">
    "Invalid state", "invalid\_grant", "fetch failed": what they mean and how to recover.
  </Card>

  <Card title="Uploads & media" icon="cloud-arrow-up" href="/troubleshooting/uploads">
    Payload-too-large, video failures, cancel-in-flight.
  </Card>

  <Card title="Activation & login" icon="key" href="/troubleshooting/activation-and-login">
    Expired activation links, "jwt malformed", login API 404/204.
  </Card>

  <Card title="Billing" icon="credit-card" href="/troubleshooting/billing">
    Stripe.js blocked, billing page broken in incognito, discount apply errors.
  </Card>

  <Card title="Channel limits" icon="user-group" href="/troubleshooting/channel-limits">
    "You have reached the maximum number of channels".
  </Card>

  <Card title="Known issues" icon="circle-exclamation" href="/troubleshooting/known-issues">
    Live tracker of bugs we are aware of, with workarounds.
  </Card>
</CardGroup>

## Self-hosted

<CardGroup cols={2}>
  <Card title="Self-host gotchas" icon="server" href="/troubleshooting/self-host">
    pnpm OOM and port confusion, plus hiding providers and Vercel.
  </Card>

  <Card title="System requirements" icon="microchip" href="/installation/system-requirements">
    Minimum CPU/RAM, required services, default ports.
  </Card>

  <Card title="WebSockets & dev tunnels" icon="bolt" href="/reverse-proxies/websockets-and-dev">
    HMR over ngrok, allowedDevOrigins, redirectmeto OAuth proxy.
  </Card>

  <Card title="Uploads & storage" icon="folder" href="/configuration/uploads">
    Mounting UPLOAD\_DIRECTORY, local vs Cloudflare R2.
  </Card>
</CardGroup>

## Still stuck?

<CardGroup cols={1}>
  <Card title="Talk to a human" icon="headset" href="/support">
    Where to send it, and what to include so the first reply is the useful one.
  </Card>
</CardGroup>

Not a fault, just a question? The [FAQ](/faq) covers the ones that come up most.