Deploy and Host

Run SiYuan v3.8.1 as one authenticated Railway service with a persistent workspace, immutable image pins, non-root steady processes, and true boot-progress readiness.

About Hosting

Wait for deployment health, open the Railway domain, and enter the generated access code from Railway Variables. Create a synthetic notebook, note, asset, and search before importing important data.

Common Use Cases

Run an authenticated SiYuan workspace.
Create notebooks, notes, assets, and searches with persistent workspace data.
Verify recovery in a fresh volume before importing important data.

Dependencies for

One public application service.
One volume at /siyuan/workspace.
One generated access code with bypass disabled.
HTTPS target port 8080 and /healthz.
One replica and Serverless disabled.
Exact upstream and build-image digests.

Why Deploy

The deployment keeps SiYuan in one authenticated service with a persistent workspace, immutable image pins, non-root steady processes, and boot-progress readiness.

Persistence and recovery

Back up the complete stopped /siyuan/workspace tree, including configuration and repository-key material. Restore the complete archive to a fresh volume with UID/GID 1000 and verify auth, notes, assets, search, and repository access. Partial or live copies are not claimed as complete backups.

Support

Template issues cover package pins, Railway wiring, readiness, authentication, volume ownership, and documentation. SiYuan application issues belong upstream; Railway account, billing, domain, and volume incidents belong to Railway support. Never post access codes, repository keys, cookies, notes, assets, archives, private URLs, or unredacted logs.