Publit.Si
Docs›Open a tunnel with Cloudflare

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
  • cloudflared from Install the tools
  • Only needed for Instagram, Facebook, Threads, LinkedIn, TikTok, or YouTube without the weekly reconnect – never for X

Check your domain

  1. 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.

    Cloudflare, Domains overview with the domain example.com and status Active
    1. 1:Domains › Overview
    2. 2:Active
    Domains → Overview: your domain must show Active before the tunnel works.
  2. Pick a subdomain for Publit.Si, for example publish.example.com. It must not exist yet.

Create the tunnel

  1. Sign in. A browser window opens; pick your domain there:

    cloudflared tunnel login
  2. Create the tunnel. Note the tunnel UUID it prints:

    cloudflared tunnel create publitsi
  3. Point 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
    Cloudflare DNS records: the publish record with type Tunnel, opened to show CNAME and a cfargotunnel.com target
    1. 1:Type Tunnel
    2. 2:CNAME → …cfargotunnel.com
    After cloudflared tunnel route dns, your subdomain shows type Tunnel. Opened, it's a CNAME to …cfargotunnel.com.
  4. Copy the config template (Windows: Copy-Item ops\cloudflared\publitsi.yml.example $HOME\.cloudflared\publitsi.yml):

    cp ops/cloudflared/publitsi.yml.example ~/.cloudflared/publitsi.yml
  5. Open ~/.cloudflared/publitsi.yml and replace <TUNNEL-UUID> (twice), /Users/<you> (Windows: C:/Users/<you>, Linux: /home/<you>) and publish.example.com.

Tell Publit.Si its address

  1. Add these lines to .env:

    PUBLITSI_PUBLIC_URL=https://publish.example.com
    PUBLITSI_OPERATOR_NAME=Your name or company
    PUBLITSI_OPERATOR_EMAIL=you@example.com
  2. Name and email appear on your gateway's public /privacy and /terms pages. Meta, Google and TikTok look at them when they check your app.

Turn off Bot Fight Mode

  1. 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.

    Cloudflare Security, Settings with the search Bot fight mode and its switch turned off
    1. 1:Security › Settings
    2. 2:Search “Bot fight mode”
    3. 3:Off
    Security → Settings → search “Bot fight mode” → switch it off, or Instagram can't fetch your media.
Alternative

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.

  1. Install Tailscale (Mac: brew install tailscale or the App Store app; Windows: winget install Tailscale.Tailscale; Linux: tailscale.com/download) and sign in:

    tailscale up
  2. In the Tailscale admin console turn on MagicDNS and HTTPS Certificates. The first tailscale funnel command asks you to allow Funnel; follow the link.

  3. Open the gateway to the internet. --bg keeps it running after a restart. It prints your address, e.g. https://my-mac.tail1234.ts.net:

    tailscale funnel --bg 3100
  4. Put that address into .env as PUBLITSI_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:setup shows ✗ for cloudflared
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) and PUBLITSI_PUBLIC_URL. With Tailscale Funnel: tailscale funnel status must list port 3100 and the same address as PUBLITSI_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.