---
title: "Deploy WriteFreely"
description: "Minimalist, federated blogging with Markdown, ActivityPub and MariaDB"
category: "Blogs"
url: https://railway.com/deploy/writefreely-2
---

# Deploy WriteFreely

Minimalist, federated blogging with Markdown, ActivityPub and MariaDB

**[Deploy WriteFreely on Railway](https://railway.com/template/writefreely-2)**

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

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

## Template content

### MariaDB https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mariadb.png

- **Source:** https://github.com/aalfath/writefreely-railway-template

### WriteFreely https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/writefreely.png

- **Source:** https://github.com/aalfath/writefreely-railway-template
- **Health check:** /api/nodeinfo
- **Public domain:** Yes

## Documentation

# Deploy and Host WriteFreely on Railway

WriteFreely is open-source software for minimalist, federated blogging. Writers get a clean Markdown editor, one or more blogs per account, and posts that people can follow from Mastodon and other ActivityPub servers. This template deploys WriteFreely 0.17.3, the latest stable release, as a multi-user instance with your admin account already created.

## About Hosting WriteFreely

WriteFreely is a single Go program that keeps its posts and accounts in a MySQL-compatible database and its config file and encryption keys on disk. This template runs two services on Railway's private network: WriteFreely (the public web service, with config and keys on a volume) and MariaDB 11.8 LTS (on its own volume). On the first boot the start script writes the config, creates the tables and keys, and creates your admin account from generated credentials, so nobody else can claim the instance. Later boots run database migrations. The public URL is wired in automatically. Both services fit in 0.5 GB of RAM.

## Common Use Cases

* A personal blog with a distraction-free editor that Mastodon users can follow
* A small writing community, team journal or class blog with invite-only accounts
* An internal knowledge or announcements blog with private or members-only posts

## Dependencies for WriteFreely Hosting

* MariaDB 11.8 (bundled, own volume)

### Deployment Dependencies

* [WriteFreely documentation](https://writefreely.org/docs)
* [WriteFreely 0.17.3 release](https://github.com/writefreely/writefreely/releases/tag/v0.17.3)
* [Official container image](https://github.com/writefreely/writefreely/pkgs/container/writefreely)
* [Template source](https://github.com/aalfath/writefreely-railway-template)

### Implementation Details

**After you deploy:** open the WriteFreely service's variables and copy `WRITEFREELY_ADMIN_PASSWORD` (generated) and `WRITEFREELY_ADMIN_USER` (default `owner`). Open the public URL, choose "Log in" and sign in. Your first blog has the admin's username. Then open Admin → Settings to set the site name and description, and choose whether people may sign up: registration is closed by default and only the admin can send invites. Change your password under your account's settings; the variable is only used to create the account on the first boot.

**Services:**

* **WriteFreely**: port 8080, health check `/api/nodeinfo` (answers without login, also when the instance is set to private). The volume at `/data` holds `config.ini`, the encryption keys (`/data/keys`) and a first-boot marker. Settings you save in the admin panel are kept across redeploys; only the port, database connection and public URL are refreshed from variables on each start.
* **MariaDB**: WriteFreely's database (posts, accounts, blogs), data on the volume at `/var/lib/mysql`. Tuned to fit 0.5 GB of RAM.

**Options:** email (password reset, newsletters) needs SMTP or Mailgun settings in the `[email]` section of `/data/config.ini`; see the [config reference](https://writefreely.org/docs/latest/admin/config). Single-user mode and other settings are in the admin panel. To use your own domain, add it to the WriteFreely service in Railway and set `WRITEFREELY_HOST` to `https://YOUR-DOMAIN` before you start federating, because ActivityPub followers are tied to that address.

**Updates:** both services build from this template's GitHub repo, which pins each image by version and digest. When we release a new version, Railway shows an update in your project; read [CHANGELOG.md](https://github.com/aalfath/writefreely-railway-template/blob/main/CHANGELOG.md) first, then apply it. WriteFreely runs its database migrations on the next start.

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

- [Pixelfed](https://railway.com/deploy/OZSdEw) — Explore + Share beautiful photos and videos on the Fediverse
- [Hexo](https://railway.com/deploy/hexo) — Hexo — fast static blog framework with admin editor and S3 media storage
- [Castopod](https://railway.com/deploy/castopod-clone) — Self-hosted podcast hosting with Fediverse support

Open this page in a browser: https://railway.com/deploy/writefreely-2
