selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

changerawr logo

Self-host changerawr

v1.0.7.4

Changelog management with widgets, API, and email

ReleaseSource AvailableOther
Updated13 hours ago
LanguageTypescript
Setup difficultyModerate
ThemeDark mode
Stars
325
Port
3000 (Next.js application server)
Requires
Node.js, PostgreSQL
Docker
ghcr.io/supernova3339/changerawr
Install with Docker Compose
Admin user management dashboardAdmin audit logs viewAI settings configurationTag management interfaceAbout and system information pageCatch-up view for changelog entriesChangelog import functionalityPublic changelog pageMain Changerawr dashboard

What is changerawr?

Changerawr is a changelog management system (CMS) that lets developers write changelog entries once and publish them everywhere — as a public page on a custom domain, embeddable widgets for websites, email notifications to subscribers, and a headless REST API with SDKs and a CLI. It features a content editor with full revision history, AI-assisted writing, tags and versioning, passkey/OAuth2/SAML authentication, full-text search, and a Slack integration. The software runs on Node.js 24+ with PostgreSQL and is deployed via Docker Compose or manual build. It uses a custom Non-Commercial Open Source License that permits commercial use but prohibits selling the software itself. The project is production-ready with regular releases.

Should you self-host changerawr?

changerawr scores 48/100 on selfhost.directory (how scoring works) and ranks #15 of 18 in Content Management. It has 325 GitHub stars.

It shipped 8 stable releases in the past year. The latest, v1.0.7.4, came out on 17 September 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is EmDash (67/100, 14 030 stars). It scores higher overall, so compare the two before you pick. See changerawr vs EmDash side by side.

Features

  • AI-assisted writingOptional AI tagger service required for tag suggestions
  • Changelog editor with revision history
  • CLI Tool
  • Custom domains with SSLRequires nginx-agent setup for SSL certificates
  • Email notifications
  • Embeddable Widgets
  • Extensible markdown engine
  • Full-Text Search
  • Headless / REST API
  • Passkey, OAuth2, and SAML authentication
  • Public changelog pages
  • SDKs for popular languages
  • Slack integration
  • Tags and versioning

changerawr README

How to install changerawr

Install changerawr with Docker Compose

Docker and Docker Compose
Environment variables
DATABASE_URL, JWT_ACCESS_SECRET, NEXT_PUBLIC_APP_URL, GITHUB_ENCRYPTION_KEY, ANALYTICS_SALT, CHANGELOG_TAGGER_URL

docker-compose up --build

Includes PostgreSQL, app, optional AI tagger, and optional Caddy reverse proxy with TLS

How to configure changerawr

  • ACME_EMAILLet's Encrypt email

    Let's Encrypt email

  • ACME_SANDBOX_MODEfalseLegacy (same as ACME_STAGING)

    Legacy (same as ACME_STAGING)

  • ACME_STAGINGtrueUse staging (true = test certs, false = production) Staging certs work but aren't browser-trusted. Good for testing.

    Use staging (true = test certs, false = production) Staging certs work but aren't browser-trusted. Good for testing.

  • ALLOWED_EXTERNAL_DOMAINSExtra allowed domains beyond defaults (cloudflareinsights.com, cdnjs.cloudflare.com, unpkg.com, cdn.jsdelivr.net, fonts.googleapis.com, fonts.gstatic.com)

    Extra allowed domains beyond defaults (cloudflareinsights.com, cdnjs.cloudflare.com, unpkg.com, cdn.jsdelivr.net, fonts.googleapis.com, fonts.gstatic.com)

  • ANALYTICS_SALTAnalytics salt

    Analytics salt

  • CHR_EPOA2_SERV_API_KEY
  • CHR_EPOA2_SERV_URL
  • COOKIE_SECUREtrueCookie settings (false for localhost, true for HTTPS)

    Cookie settings (false for localhost, true for HTTPS)

  • COOKIE_SECURE_DOMAINSComma-separated domains for cookie control

    Comma-separated domains for cookie control

  • DATABASE_URLpostgresql://postgres@localhost:5432/changerawr?schema=publicDatabase (PostgreSQL)

    Database (PostgreSQL)

  • EASYPANEL_API_KEY
  • EASYPANEL_PANEL_URL
  • EASYPANEL_PROJECT_ID
  • EASYPANEL_SERVICE_ID
  • ENABLE_JOB_RUNNERfalseJob runner (true in dev if testing scheduled jobs)

    Job runner (true in dev if testing scheduled jobs)

  • ENCRYPTION_KEYCertificate encryption Generate: node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"

    Certificate encryption Generate: node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"

  • GITHUB_ENCRYPTION_KEY
  • INTERNAL_API_SECRETAPI auth (must match INTERNAL_API_SECRET in nginx-agent)

    API auth (must match INTERNAL_API_SECRET in nginx-agent)

  • JWT_ACCESS_SECRETJWT secret for tokens

    JWT secret for tokens

  • NEXT_PUBLIC_APP_URLhttp://localhost:3000Public URL (http://localhost:3000 or https://your-domain.com)

    Public URL (http://localhost:3000 or https://your-domain.com)

  • NEXT_PUBLIC_ENABLE_CUMtrueMarkdown editor toolbar

    Markdown editor toolbar

  • NEXT_PUBLIC_SHOW_WWC_TOOLINGfalseDev tooling

    Dev tooling

  • NEXT_PUBLIC_SSL_ENABLEDfalseShow SSL UI in dashboard

    Show SSL UI in dashboard

  • NGINX_AGENT_SECRETWebhook signing (must match AGENT_SECRET in nginx-agent)

    Webhook signing (must match AGENT_SECRET in nginx-agent)

  • NGINX_AGENT_URLhttp://localhost:7842
  • SETUP_COMPLETEfalseSet to false after setup wizard completes

    Set to false after setup wizard completes

  • SHOW_TELEMETRY_LOGSDebug telemetry (leave off)

    Debug telemetry (leave off)

  • SSL_RENEWAL_BATCH_SIZE10Max certs per cron run (default: 10)

    Max certs per cron run (default: 10)

  • SSL_RENEWAL_THRESHOLD_DAYS30Days before expiry to renew (default: 30)

    Days before expiry to renew (default: 30)

changerawr releases & version history

More in Content Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…