Deploy Bludit
Simple flat-file CMS for sites and blogs: no database, PHP 8.4 + Apache
Just deployed
/var/www/html/bl-content
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.
Template Content