Publit.Si
Docs›Start Publit.Si

Installation

Start Publit.Si

Publit.Si runs four small services: the app, a worker that posts on time, the gateway and the tunnel. Let them start with your computer, or start them by hand.

Start automatically (recommended)

  1. In the publitsi folder:

    pnpm ops:install
  2. It builds the app and starts everything at every login. Publit.Si opens at localhost:3000 once it's ready.

  3. Mac: LaunchAgents. Windows: tasks in the Task Scheduler (folder PublitSi) that run without a window and restart if they crash. Linux: systemd user services; check them with systemctl --user status 'publitsi-*'.

  4. To remove them again: pnpm ops:uninstall.

Or start by hand

  1. Run pnpm dev, open localhost:3000, go to Settings › Status and click Start all.

Check the status

  1. Settings › Status shows worker, gateway and tunnel. All green means Publit.Si can post.

    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.
  2. On the Mac, the first notification asks whether “PublitSi” may send notifications. Click Allow.

  3. Want to look around first? The Overview offers Explore with demo data. It never posts anything real; Remove demo takes it away.

Optional

Use another port

Publit.Si opens at port 3000. When another program already uses that port, pick another one in the app.

  1. Open [127.0.0.1:3000](http://127.0.0.1:3000), then Settings › General › Address.

  2. Enter a free Port from 1024 to 65535 and click Save and restart.

  3. Publit.Si saves it and starts again on the new port. The page follows by itself. Links in notifications and sign-ins use the new address.

  4. YouTube and the blog's Search Console sign in through this address. Update their redirect URIs in Google Cloud: Settings › Platform setup shows the new ones.

Check

Settings › Status shows worker, gateway and tunnel in green (YouTube only: the tunnel may stay off). After changing .env, run pnpm ops:install again.

Troubleshooting

Windows: pnpm ops:install can't create a task
Run it in a normal (not elevated) PowerShell as the user who should run Publit.Si.
Linux: systemctl --user says "Failed to connect to bus"
Log in as that user directly (desktop or ssh user@server), not via su/sudo -u. Proxmox/LXC: pct enter logs you in as root – create a normal user and SSH in as that user (see "Linux server"). Without systemd, run pnpm dev and pnpm services yourself (e.g. in tmux).
Linux: services stop when you log out, or don't start after a reboot
Run sudo loginctl enable-linger $USER once (step 7).
Migration says the database is busy
Stop pnpm dev and close old Claude Code, Codex, Cursor or OpenCode sessions; the command lists the processes.
localhost:3000 shows "404 – not found" or another app
Another program uses port 3000 too. Open http://127.0.0.1:3000, then pick another port under Settings › General › Address – Publit.Si restarts on it. With an autostart from before v1.6.1, run pnpm ops:install once. Update the YouTube and Search Console redirect URIs in Google Cloud afterwards.
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.

Stuck? Search the troubleshooting list or write to us . Leave out secrets and tokens.