---
title: "Deploy Chirp Changelog"
description: "Deploy a polished Chirp changelog and release-notes site with PostgreSQL."
category: "Blogs"
url: https://railway.com/deploy/chirp-changelog
---

# Deploy Chirp Changelog

Deploy a polished Chirp changelog and release-notes site with PostgreSQL.

**[Deploy Chirp Changelog on Railway](https://railway.com/template/chirp-changelog)**

- **Creator:** Lawrence Lane's Projects
- **Category:** Blogs

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### web

- **Source:** https://github.com/lbliii/chirp-changelog
- **Public domain:** Yes

## Documentation

# Deploy and Host a Changelog with Chirp

Launch a polished public changelog and release-notes archive powered by Chirp and PostgreSQL. Publish safe Markdown updates, keep drafts private, organize releases with tags, and give visitors searchable HTML, stable permalinks, and a standards-based Atom feed.

## About Hosting

The template provisions one Chirp web service and one Railway-managed PostgreSQL service. Railway generates the application signing key and owner token, supplies the database URL and public domain, runs database migrations before each release is promoted, and checks `/ready` before routing traffic to the deployment.

The application uses server-rendered HTML with HTMX enhancements, so every owner workflow also works without JavaScript. PostgreSQL owns all durable release data. Redis is not required because Chirp uses signed cookie sessions and the starter does not depend on a shared cache, job queue, or cross-worker realtime fan-out.

## Why Deploy

- Give a product a useful release-notes home in one click.
- Publish sanitized Markdown without adding a CMS or account system.
- Offer both a polished human archive and a machine-readable Atom feed.
- Get generated secrets, migrations, and readiness checks without manual wiring.
- Own the application code and PostgreSQL data after deployment.

## Common Use Cases

- Product and SaaS release notes
- Open-source project changelogs
- Internal platform announcements
- API and developer-tool updates
- A production-shaped Chirp learning project

## Dependencies for Chirp Changelog

### Deployment Dependencies

- A Chirp web service built from `lbliii/chirp-changelog`
- Railway PostgreSQL with persistent storage
- Python 3.14 and the locked application dependencies

No Redis service or external SaaS account is required. After deployment, open the generated public domain to view the changelog. Retrieve `CHANGELOG_ADMIN_TOKEN` from the web service variables when you need owner access.

Framework documentation: https://lbliii.github.io/chirp/

Starter source and support: https://github.com/lbliii/chirp-changelog


## Similar templates

- [Pixelfed](https://railway.com/deploy/OZSdEw) — Explore + Share beautiful photos and videos on the Fediverse
- [NodeBB](https://railway.com/deploy/nodebb) — Node.js based forum software built for the modern web
- [WordPress + MySQL](https://railway.com/deploy/yG1Jw8) — Zero Config | One click | WordPress | Docker | MySQL

Open this page in a browser: https://railway.com/deploy/chirp-changelog