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.
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.
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 publitsiLog in over SSH as that user (
ssh publitsi@container) and do every step from there – not throughsuorsudo -u.
Install over SSH
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.
Log in as the user who runs Publit.Si directly (
ssh user@server), not throughsuorsudo -u, sosystemctl --userworks.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
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@serverThen 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 --usersays "Failed to connect to bus" - Log in as that user directly (desktop or
ssh user@server), not viasu/sudo -u. Proxmox/LXC:pct enterlogs you in as root – create a normal user and SSH in as that user (see "Linux server"). Without systemd, runpnpm devandpnpm servicesyourself (e.g. in tmux). - Linux: services stop when you log out, or don't start after a reboot
- Run
sudo loginctl enable-linger $USERonce (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:
cdinto thepublitsifolder, thenpnpm install && pnpm ops:install. Details are inlogs/update.logandrun/update.jsonin the data folder (Linux:~/.local/share/PublitSi/). On Linux, worker, gateway or tunnel may be off afterwards:pnpm ops:installstarts 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.