Publit.Si
Docs›All problems

Troubleshooting

Troubleshooting

Errors people ran into while setting up Publit.Si, and the fix for each. Type your error message below, or pick a section. Most fixes link to the right spot in the docs, with a screenshot. Your coding agent knows this list too. Nothing helps? See Logs and support.

Install and start

Tunnel

  • Tunnel stays red

    Check ~/.cloudflared/publitsi.yml (UUID, credentials file, hostname) and PUBLITSI_PUBLIC_URL. With Tailscale Funnel: tailscale funnel status must list port 3100 and the same address as PUBLITSI_PUBLIC_URL.

    Show where to fix it
    Publit.Si Settings, Status: Worker, Gateway (local) and Public URL (tunnel) with green dots
    1. 1:Worker
    2. 2:Public URL (tunnel)
    Settings › Status: worker, gateway and tunnel are green. With YouTube only, the tunnel may stay off.
    Fix it in “Open a tunnel with Cloudflare” →

Connecting any platform

Instagram

LinkedIn

YouTube

Most YouTube problems come from Google's test mode: add yourself as a test user, and reconnect every 7 days or switch to production. Test mode or production? →

X

  • X post never shows as published

    An X post is only marked published after you click It’s online on its copy page or in the queue. Publit.Si fills in nothing on x.com and cannot see what you post there. Still waiting? Open Queue › Waiting for you, click It’s online and paste the post's link.

    Fix it in “Connect X” →

TikTok

  • TikTok rejects the login with a scope error

    The statistics scopes aren't enabled. Switch off TikTok: statistics under Settings › Platforms › Statistics and comments (or set TIKTOK_ANALYTICS=0 and restart), then reconnect.

    Show where to fix it
    TikTok app scopes: user.info.basic, video.publish, video.upload and two more user info scopes
    1. 1:user.info.basic
    2. 2:video.publish
    3. 3:video.upload
    Scopes: Publit.Si needs these three. For statistics also user.info.stats and video.list (Display API).
    Fix it in “Connect TikTok” →
  • TikTok post never gets marked as published

    By default, confirm "It’s online" on the copy page or in the queue after posting yourself. With the optional extension, check it is installed in the right Chrome profile and turned on for this account; confirm "It’s online" yourself if needed.

    Show where to fix it
    chrome://extensions with Developer mode on, the Load unpacked button and the Publit.Si Helper card
    1. 1:Developer mode
    2. 2:Load unpacked
    3. 3:Publit.Si Helper
    chrome://extensions → Developer mode on → Load unpacked → the extension/ folder.
    Fix it in “Connect TikTok” →

Studio and AI

Blog

Still stuck? The logs and how to reach us are on Logs and support.