Deploy and Host Poznote on Railway

Poznote is a powerful note-taking and documentation platform focused on simplicity. Create rich HTML or Markdown notes with checklists, Excalidraw diagrams, Mermaid charts, KaTeX formulas, and file attachments. Organize your knowledge with workspaces, folders, tags, and full-text search.

About Hosting Poznote

Hosting Poznote on Railway allows you to deploy a production-ready Poznote instance without managing a server yourself. Railway runs the official Poznote Docker image and provides persistent storage for your notes, attachments, and SQLite database. The application can be accessed from any device through a web browser, while your data remains under your control.

The Railway template is configured with a persistent volume mounted at /var/www/html/data, ensuring that your data survives redeployments and application updates. Once deployed, Railway provides a public domain for accessing your Poznote instance.

Poznote is lightweight and does not require an external database. It uses SQLite and stores notes and attachments directly in the persistent data directory.

Common Use Cases

Personal knowledge management and technical note-taking.
Documentation and knowledge bases for teams.
Writing and organizing Markdown and HTML notes.
Storing code snippets, diagrams, and technical documentation.
Self-hosting an alternative to cloud note-taking applications such as Notion, Evernote, or OneNote.

Dependencies for Poznote Hosting

Railway persistent volume — Required to persist the SQLite database, notes, and file attachments across deployments.
SQLite — Used as Poznote's database; no separate database service is required.
Docker — Poznote is deployed using the official Poznote Docker image.

Links

Poznote website: https://poznote.com
Source code and documentation: https://github.com/timothepoznanski/poznote
Official Docker image: https://github.com/timothepoznanski/poznote/pkgs/container/poznote

Implementation Details

The Railway template uses the official Poznote Docker image:

ghcr.io/timothepoznanski/poznote:latest

A persistent Railway volume is mounted at:

/var/www/html/data

This directory contains the SQLite database, notes, workspaces, and attachments.

Poznote listens on port 80 inside the container. Railway automatically exposes the application through its generated public domain.

Environment Variables

POZNOTE_OIDC_CLIENT_ID

Optional OpenID Connect client ID used when configuring OIDC/SSO authentication with an external identity provider such as Keycloak, Auth0, Azure AD, or Google. Leave empty if OIDC authentication is not being used.

POZNOTE_OIDC_CLIENT_SECRET

Optional OpenID Connect client secret associated with the OIDC client ID.

Leave empty if OIDC authentication is not being used.

POZNOTE_OIDC_DISABLE_NORMAL_LOGIN

Controls whether the normal username/password login form is disabled when OIDC is configured.

Set to true to require users to authenticate exclusively through OIDC. Set to false to keep normal username/password authentication available.

Why Deploy Poznote on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration.

By deploying Poznote on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.