Publit.Si
Docs›Linux server

Installation

Linux server (no screen)

Publit.Si also runs on a Linux server without a desktop, for example a small home server that is always on. You install it over SSH and open the app through an SSH tunnel.

Optional

Proxmox or LXC container

pct enter and the container console log you in as root. systemctl --user then fails with “Failed to connect to bus”. Don't run Publit.Si as root.

  1. In the container, as root, create a normal user once and let its services run without a login (Debian/Ubuntu; any user name works):

    adduser publitsi
    apt install sudo && usermod -aG sudo publitsi
    loginctl enable-linger publitsi
  2. Log in over SSH as that user (ssh publitsi@container) and do every step from there – not through su or sudo -u.

Install over SSH

  1. Do Get the code, Install the tools and, for Instagram, Facebook, Threads, LinkedIn and TikTok, the Cloudflare tunnel over SSH as usual. Skip the desktop-only packages.

  2. Log in as the user who runs Publit.Si directly (ssh user@server), not through su or sudo -u, so systemctl --user works.

  3. Start Publit.Si with your server and keep it running after you log out:

    pnpm ops:install
    sudo loginctl enable-linger $USER

Open the app

  1. The app only listens on 127.0.0.1. From your own computer, open an SSH tunnel:

    ssh -L 3000:127.0.0.1:3000 user@server
  2. Then open localhost:3000 on your computer. OAuth sign-ins return to http://localhost:3000/… and work through the same tunnel.

What works without a screen

Without a desktop, Publit.Si skips opening links and folders, notifications, the folder dialog and keep-awake. The optional Chrome extension for TikTok Studio needs a desktop. For TikTok Studio and X, open Queue › Waiting for you through the SSH tunnel on your own computer, use the copy page and post in your browser yourself. TikTok's direct API posting also works on the server (private until your app passes its audit).

The token key is stored in master-key in the data folder (~/.local/share/PublitSi/), readable only by you. pnpm backup includes it.

Check

systemctl --user status 'publitsi-*' shows the services as active, and Settings › Status is green in the browser on your computer.

Troubleshooting

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).
Update hangs, or the worker is stuck after "Update now"
Log in (over SSH on a server) as the user who runs Publit.Si and finish the update by hand: cd into the publitsi folder, then pnpm install && pnpm ops:install. Details are in logs/update.log and run/update.json in the data folder (Linux: ~/.local/share/PublitSi/). On Linux, worker, gateway or tunnel may be off afterwards: pnpm ops:install starts them again. From v1.13 the update runs as its own systemd user service and survives stopping the web service, also in LXC containers. Updating from an older version in a container: do it once by hand like this.
Linux: "The master key is in the desktop keyring … but no keyring is reachable"
The key was stored in the keyring of your desktop session. Run Publit.Si in that session, and install secret-tool (libsecret-tools; Fedora: libsecret).
YouTube: browser cannot open localhost after Google sign-in
Keep Publit.Si running and use the exact callback shown under Settings → Platform setup → YouTube, including host and port. Open the app on the same computer as the browser, or use the SSH tunnel described in SETUP.md for a server. A phone or another computer's localhost points to that device, not your Publit.Si installation.

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