Sovrium Blog

A self-hostable blog CMS — a WordPress alternative.

Built with Sovrium — a configuration-as-code interpreter: one config file in, a complete self-hosted web application out.

Use this template

Click Use this template on GitHub to copy this app into your own repository (clean history, yours to modify), or scaffold it locally:

curl -fsSL https://sovrium.com/install | sh
sovrium init my-blog --template blog

What's inside

Public reading experience (index + post detail) plus an authenticated admin space to write and publish articles. Tables: authors, tags, posts (rich-text). Includes a blog-editor AI agent.

Everything is declared in app.yaml and the config/ tree — no application code. Edit the config, restart, done.

Run locally

sovrium start app.yaml

Zero-config: embedded SQLite, local file storage, no env vars required to boot. See .env.example for the optional variables (database, auth bootstrap, email, AI).

The built-in AI assistant needs an AI provider (AI_PROVIDER + AI_API_KEY, or a local Ollama via AI_BASE_URL). Without one, deploy anyway — the rest of the app works and the assistant stays off.

Email flows (sign-in links, notifications) need SMTP_* variables. Without them the app runs with email disabled.

Deploy

The Deploy on Scalingo button above provisions the app with a PostgreSQL addon (Scalingo's filesystem is ephemeral — the database keeps your data across deploys; file uploads are stored in Postgres too). Secrets are generated automatically; you only fill in BASE_URL. Any other host works the same way: run the sovrium binary with this config (see DEPLOY.md).

About this repository

This repository is auto-published from the Sovrium monorepo on every release (source: templates/blog). Issues are welcome here; please send code contributions upstream to the monorepo so the template stays in sync with the engine. The pinned engine release lives in .sovrium-version.

License: MIT. The Sovrium engine itself is licensed separately (BSL 1.1).