Get started
How Publit.Si works
Publit.Si runs entirely on your own computer. There is no Publit.Si server and no account with us: your posts, tokens and statistics stay on your disk, and the platforms are reached with developer apps you create yourself.
The four services
pnpm ops:install starts all of them at login; Settings › Status shows whether each one runs.
| Service | Address | What it does |
|---|---|---|
web | http://localhost:3000 | The app you use in the browser. It only listens on your computer. |
worker | none | Publishes due posts, retries failures, renews tokens and fetches statistics. |
gateway | 127.0.0.1:3100 | The only part reachable from outside, through the tunnel: signed media links, OAuth callbacks and your public privacy and terms pages. |
tunnel | your subdomain | A Cloudflare Tunnel from e.g. https://publish.example.com to the gateway. Only needed for Instagram, TikTok and YouTube production. |
How a post gets published
You (or your agent) create a post with media and text for one or more accounts, and schedule it.
When it's due, the worker sends it with the platform's official API, using your own developer app and the account's token.
Instagram, Threads and TikTok don't accept uploads: they download the media from a link. The gateway serves it through the tunnel with a signed link that expires after one hour. Facebook, LinkedIn and YouTube take uploads straight from your computer.
TikTok via TikTok Studio, X and Reddit are the exceptions: no API – a copy page opens with the text and media, and you post them yourself. For TikTok Studio, the optional Chrome extension can fill in the site for you; that is a grey area under the platform's rules, so it is off until you accept the risk.
The post moves to published, and its numbers show up in Analytics.
Your computer must be awake
Publit.Si can only post while your computer is on and awake. Missed posts go out when it wakes, within a grace period of two hours (PUBLITSI_GRACE_MINUTES). After that they are marked as failed for you to review.
Public YouTube videos are the exception: Publit.Si uploads them ahead of time as private with a publish time, and YouTube makes them public on its own.
On the Mac and Windows, Publit.Si can wake the computer a few minutes before each post.
Where your data lives
OAuth tokens are encrypted with AES-256-GCM. Back everything up with pnpm backup; see Backup and moving.
| What | Where |
|---|---|
| Database, media, logs | Mac: ~/Library/Application Support/PublitSi/, Windows: %LOCALAPPDATA%\PublitSi\, Linux: ~/.local/share/PublitSi/ (PUBLITSI_DATA_DIR changes it) |
| Content folders | content/<project>/ in the repository: eingang, backlog, online. Not in Git. |
| App keys and settings | .env in the repository. Never committed. |
| Token key | Mac Keychain, Windows DPAPI, the Linux keyring, or a master-key file only you can read |
Where AI comes in
AI is optional. Captions, New text with AI and analysis use your existing Claude Code, Codex, Cursor or OpenCode login. Studio runs your coding agent inside your own project's repository, so it can render Shorts with your scripts. Usage counts against your own plan; Publit.Si has no API key of its own.
Agents only create drafts. You approve and schedule them under Queue › Review.
Stuck? Search the troubleshooting list or write to us . Leave out secrets and tokens.