---
title: "Deploy Poznote"
description: "Poznote is a note-taking and documentation platform."
category: "Other"
url: https://railway.com/deploy/poznote
---

# Deploy Poznote

Poznote is a note-taking and documentation platform.

**[Deploy Poznote on Railway](https://railway.com/template/poznote)**

- **Creator:** Timothé Poznanski
- **Category:** Other
- **Total deploys:** 1

## Template content

### timothepoznanski/poznote:latest

- **Image:** ghcr.io/timothepoznanski/poznote:latest

## Documentation

# 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](https://poznote.com)
- [GitHub repository](https://github.com/timothepoznanski/poznote)
- [Docker image on GHCR](https://ghcr.io/timothepoznanski/poznote)
- [Live demo](https://demo.poznote.com) (login: `poznote` / `poznote`)
- [API documentation](https://github.com/timothepoznanski/poznote#api-documentation)

### Implementation Details

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

```
GET /api/health
```

Optional environment variables:

```env
# 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.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/poznote