---
title: "Deploy Cooee"
description: "Changelogs on autopilot. Powered by AI."
category: "Automation"
url: https://railway.com/deploy/cooee
---

# Deploy Cooee

Changelogs on autopilot. Powered by AI.

**[Deploy Cooee on Railway](https://railway.com/template/cooee)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/cooee/manifest.json

- **Creator:** Big Scary Monster
- **Category:** Automation

## Template content

### Cron

- **Source:** https://github.com/cooeehq/cooee
- **Start command:** `bun run railway:cron`

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

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

### MCP

- **Source:** https://github.com/cooeehq/cooee
- **Start command:** `bun run --cwd apps/mcp build && bun run --cwd apps/mcp start`
- **Health check:** /health
- **Public domain:** Yes

### Cooee

- **Source:** https://github.com/cooeehq/cooee
- **Start command:** `bun run --filter @cooee/admin build && COOEE_STATIC_ROOT=apps/admin/dist bun --filter @cooee/api start`
- **Health check:** /api/ready
- **Public domain:** Yes

## Documentation

# Deploy and Host Cooee with Railway

Cooee turns merged GitHub pull requests into a privacy-first product
changelog. This template deploys the complete self-hosted stack: the web app,
operator dashboard, public API, scheduled worker, PostgreSQL, and the optional
read-only MCP service.

## About Hosting Cooee

Hosting Cooee gives your team its own changelog pipeline and data store. GitHub
supplies pull-request metadata, Cooee drafts and reviews customer-facing
updates, and your public feed, React embed, and MCP clients read only entries
you have published.

The default deployment uses one public Cooee origin for the operator dashboard,
public changelogs, and API. The managed marketing website and developer docs
remain on `cooee.sh`. A private worker handles scheduled jobs, while MCP runs as
a separate read-only public service.

## Why Deploy Cooee on Railway

Railway can provision the app, worker, MCP server, database, private networking,
public domains, health checks, generated secrets, and persistent storage in one
project. The template keeps configuration explicit while removing repetitive
service wiring.

GitHub-integrated deployments also make upgrades reviewable: merge a tested
release and let Railway rebuild the affected services from the repository.

## Common Use Cases

- Turn merged pull requests into reviewed product updates.
- Let coding agents classify the pull requests they create before merge.
- Publish a hosted changelog and cross-origin JSON feed.
- Add an accessible updates popup to a React 18 or 19 application.
- Let AI clients retrieve published updates through a read-only MCP tool.
- Run a private, self-hosted Cooee instance.

## Dependencies for Cooee

### Deployment Dependencies

- A Railway account and workspace.
- A GitHub OAuth app for user sign-in.
- A GitHub App with read-only pull-request, contents, and metadata access.
- An OpenAI API key for changelog drafting.
- The public Cooee repository, once released, for GitHub-integrated builds.

PostgreSQL is included in this template. No separate database account is
required.

### Services

- **Cooee** serves the operator dashboard, public changelogs, and API from one
  public origin. The managed marketing website and docs are not part of the
  template.
- **Cron** processes scheduled changelog generation every 15 minutes.
- **Postgres** stores application data on a persistent Railway volume.
- **MCP** exposes the read-only `get-changelog-updates` tool at `/mcp`.

Railway generates the database password, Better Auth secret, and GitHub webhook
secret. Service URLs and database connections use Railway reference variables,
so they stay inside the deployed project.

### Required Inputs

Create a GitHub OAuth app and GitHub App before deploying, then provide:

- `GITHUB_CLIENT_ID`
- `GITHUB_CLIENT_SECRET`
- `GITHUB_APP_ID`
- `GITHUB_APP_SLUG`
- `GITHUB_APP_PRIVATE_KEY`
- `OPENAI_API_KEY`

The GitHub App needs read-only access to pull requests, contents, and metadata,
and should subscribe to pull request, release, installation, and
installation-repository events.

To label PRs from Codex, Claude, or another compatible coding agent, install
the Cooee PR Labels skill in each developer environment. It uses the
developer's GitHub CLI permission to add labels, so the Cooee GitHub App stays
read-only. See [Coding-agent PR labels](https://github.com/cooeehq/cooee/blob/main/docs/agent-skills.md).

## After Deployment

Use the generated Cooee HTTPS domain for the GitHub integration URLs:

```text
OAuth callback:      https://YOUR_DOMAIN/api/auth/callback/github
GitHub App callback: https://YOUR_DOMAIN/api/github/callback
GitHub App webhook:  https://YOUR_DOMAIN/api/webhooks/github
```

Confirm `APP_URL` and `BETTER_AUTH_URL` use the same domain, then redeploy Cooee
and Cron. Verify:

```bash
curl --fail https://YOUR_DOMAIN/api/health
curl --fail https://YOUR_DOMAIN/api/ready
curl --fail https://YOUR_DOMAIN/api/public/openapi.json
curl --fail https://YOUR_MCP_DOMAIN/health
```

Cloudflare custom-domain automation, analytics, and object storage are disabled
or omitted by default. Add only the optional integrations you intend to
operate. Commercial hosting integrations are intentionally not part of this
repository.

For the complete environment reference, backup guidance, upgrades, and smoke
tests, read the [self-hosting guide](https://github.com/cooeehq/cooee/blob/main/docs/self-hosting.md).

## Support

- [Documentation](https://cooee.sh/docs)
- [Source and issues](https://github.com/cooeehq/cooee)
- [Security policy](https://github.com/cooeehq/cooee/blob/main/SECURITY.md)


## Similar templates

- [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker.
- [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — Automate WhatsApp workflows with Evolution API, n8n, and Postgres.
- [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage

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