Configuration
Open a tunnel with Cloudflare
Instagram, Threads and TikTok download your media from a public HTTPS address, and Facebook and LinkedIn need one for the sign-in. A Cloudflare Tunnel makes only the small Publit.Si gateway reachable, never the app itself. Your domain should stay with its current provider? Tailscale Funnel works too, without any domain (last part of this page). The same address also gives Google the homepage, privacy and terms pages it wants for YouTube production.
You need
- A domain on Cloudflare (free plan), shown as Active – or Tailscale Funnel instead
cloudflaredfrom Install the tools- Only needed for Instagram, Facebook, Threads, LinkedIn, TikTok, or YouTube without the weekly reconnect – never for X
Check your domain
Open the Cloudflare dashboard → Domains → Overview. Your domain must show Active. If you just moved it, wait: usually under an hour, sometimes up to 24 hours.
- 1:Domains › Overview
- 2:Active
Pick a subdomain for Publit.Si, for example
publish.example.com. It must not exist yet.
Create the tunnel
Sign in. A browser window opens; pick your domain there:
cloudflared tunnel loginCreate the tunnel. Note the tunnel UUID it prints:
cloudflared tunnel create publitsiPoint your subdomain at the tunnel. Cloudflare → DNS → Records then lists it with type Tunnel (a CNAME to
…cfargotunnel.com):cloudflared tunnel route dns publitsi publish.example.com- 1:Type Tunnel
- 2:CNAME → …cfargotunnel.com
cloudflared tunnel route dns, your subdomain shows type Tunnel. Opened, it's a CNAME to…cfargotunnel.com.Copy the config template (Windows:
Copy-Item ops\cloudflared\publitsi.yml.example $HOME\.cloudflared\publitsi.yml):cp ops/cloudflared/publitsi.yml.example ~/.cloudflared/publitsi.ymlOpen
~/.cloudflared/publitsi.ymland replace<TUNNEL-UUID>(twice),/Users/<you>(Windows:C:/Users/<you>, Linux:/home/<you>) andpublish.example.com.
Tell Publit.Si its address
Add these lines to
.env:PUBLITSI_PUBLIC_URL=https://publish.example.com PUBLITSI_OPERATOR_NAME=Your name or company PUBLITSI_OPERATOR_EMAIL=you@example.comName and email appear on your gateway's public
/privacyand/termspages. Meta, Google and TikTok look at them when they check your app.
Turn off Bot Fight Mode
Cloudflare → your domain → Security → Settings → search “Bot fight mode” → switch it off (older dashboards: Security → Bots). Otherwise Meta's crawler can't load your media.
- 1:Security › Settings
- 2:Search “Bot fight mode”
- 3:Off
Without Cloudflare: Tailscale Funnel
Your domains stay where they are. Any tunnel that forwards a public HTTPS address to port 3100 works; Tailscale Funnel is free for this and needs no domain. Skip the Cloudflare parts above.
Install Tailscale (Mac:
brew install tailscaleor the App Store app; Windows:winget install Tailscale.Tailscale; Linux: tailscale.com/download) and sign in:tailscale upIn the Tailscale admin console turn on MagicDNS and HTTPS Certificates. The first
tailscale funnelcommand asks you to allow Funnel; follow the link.Open the gateway to the internet.
--bgkeeps it running after a restart. It prints your address, e.g.https://my-mac.tail1234.ts.net:tailscale funnel --bg 3100Put that address into
.envasPUBLITSI_PUBLIC_URL, with your operator name and email as above.
Check
After starting Publit.Si, Settings › Status shows the tunnel in green, and https://publish.example.com/privacy opens your privacy page.
Troubleshooting
pnpm local:setupshows ✗ forcloudflared- Mac:
brew install cloudflared. Windows:winget install Cloudflare.cloudflared, then open a new PowerShell window. Linux: the .deb/.rpm from github.com/cloudflare/cloudflared/releases or pkg.cloudflare.com. - Tunnel stays red
- Check
~/.cloudflared/publitsi.yml(UUID, credentials file, hostname) andPUBLITSI_PUBLIC_URL. With Tailscale Funnel:tailscale funnel statusmust list port 3100 and the same address asPUBLITSI_PUBLIC_URL. - Instagram can't load media
- Bot Fight Mode is still on for the tunnel host.
Stuck? Search the troubleshooting list or write to us . Leave out secrets and tokens.


