Deploy and Host Poznote on Railway

Poznote is a self-hosted note-taking and documentation platform. It combines rich-text and Markdown notes, Excalidraw drawings, task lists, and file attachments with full-text search, folders, and tags. It supports multiple users, OIDC/SSO login, a REST API, an MCP server for AI assistants, and built-in backup and export.

About Hosting Poznote

Poznote ships as a single multi-arch Docker image (ghcr.io/timothepoznanski/poznote) built on PHP 8 and SQLite, so there is no separate database server to run. The container serves the web app on port 80 and stores everything, including the SQLite database, note files, and attachments, under /var/www/html/data. Hosting it means running that image, attaching a persistent volume to the data directory so your notes survive redeploys, and exposing the HTTP port. Configuration is optional and handled through environment variables (OIDC client credentials, settings-page password) or the admin UI. A health endpoint at /api/health makes uptime checks straightforward.

Common Use Cases

Personal knowledge base and second brain, accessible from any device including offline view and an Android share target
Team documentation and shared notes with multi-user accounts, workspaces, and OIDC/SSO authentication
AI-connected note store, letting assistants read and write notes through the REST API or the bundled MCP server

Dependencies for Poznote Hosting

A persistent volume mounted at /var/www/html/data (SQLite database, notes, and attachments live there)
The official Docker image ghcr.io/timothepoznanski/poznote:6 (no external database or cache required)

Deployment Dependencies

Poznote website
GitHub repository
Docker image on GHCR
Live demo (login: poznote / poznote)
API documentation

Implementation Details

The container listens on port 80 and exposes a health check endpoint:

GET /api/health

Optional environment variables:

# OIDC / SSO (other OIDC settings are managed in the admin UI)
POZNOTE_OIDC_CLIENT_ID=your_client_id
POZNOTE_OIDC_CLIENT_SECRET=your_client_secret
POZNOTE_OIDC_DISABLE_NORMAL_LOGIN=false

# Optional password protecting the Settings page
POZNOTE_SETTINGS_PASSWORD=

On first launch, log in with the default administrator account admin_change_me / admin, then rename it and change the password from Settings.

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, while allowing you to vertically and horizontally scale it.

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.