---
title: "Deploy Bludit"
description: "Simple flat-file CMS for sites and blogs: no database, PHP 8.4 + Apache"
category: "CMS"
url: https://railway.com/deploy/bludit
---

# Deploy Bludit

Simple flat-file CMS for sites and blogs: no database, PHP 8.4 + Apache

**[Deploy Bludit on Railway](https://railway.com/template/bludit)**

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

- **Creator:** Agaz Self-Host
- **Category:** CMS

## Template content

### Bludit https://cdn.jsdelivr.net/gh/bludit/bludit@3.22.0/bl-kernel/img/logo.svg

- **Source:** https://github.com/aalfath/bludit-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# Deploy and Host Bludit on Railway

Bludit is a simple, open-source CMS for websites and blogs. It stores pages, settings and users as JSON files instead of in a database, so there is nothing to set up besides a PHP web server. It ships with themes, plugins, a Markdown or WYSIWYG editor and SEO tools.

## About Hosting Bludit

Hosting Bludit needs a PHP web server that keeps the `bl-content` folder, which holds every page, setting, user and upload. This template builds Bludit 3.22.0 from its official release on the official PHP 8.4 + Apache image and puts `bl-content` on a Railway volume, so content survives redeploys and restarts. On the first boot it runs Bludit's installer itself with a generated admin password, so no visitor can claim the site through the setup page. Apache trusts Railway's proxy for HTTPS and real client IPs, and a `/healthz` check tells Railway when the site is ready. It fits in 0.5 GB of RAM.

## Common Use Cases

* A personal blog or portfolio without a database to run
* A small business, project or documentation website
* A lightweight CMS for static-style pages with an admin panel and plugins

## Dependencies for Bludit Hosting

* One Bludit service (PHP 8.4 + Apache) built from the template's GitHub repo
* One Railway volume mounted at `/var/www/html/bl-content`

### Deployment Dependencies

* Bludit source and releases: https://github.com/bludit/bludit/releases/tag/3.22.0
* Bludit documentation: https://docs.bludit.com
* Template repo: https://github.com/aalfath/bludit-railway-template

### Implementation Details

After the deploy finishes, open the public URL and sign in at `/admin` with the user `admin` and the password in the service's `BLUDIT_ADMIN_PASSWORD` variable (Variables tab). Change the password under Users after your first login: the variable is only used for the first install. To use your own domain, add it under the service's Settings, then set it under Settings → Advanced → Site URL in the Bludit admin.

Updates: the service builds from the template's GitHub repo. When we release a new Bludit version, Railway shows an "update available" notice on your project. Read `CHANGELOG.md` in the repo, then apply it. Your content stays on the volume.

## Why Deploy Bludit 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 Bludit 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

- [Libredesk - Complete Setup](https://railway.com/deploy/libredesk-complete-setup) — Complete self-hosted omnichannel customer support desk.
- [Paperless-ngx](https://railway.com/deploy/paperless-ngx-3) — Paperless-ngx — document management with OCR and full-text search
- [Instatic CMS - Postgres](https://railway.com/deploy/instatic-cms-postgres) — Design, build and manage powerful static sites from state-of-the-art CMS

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