Deploy WriteFreely

Minimalist, federated blogging with Markdown, ActivityPub and MariaDB

Deploy WriteFreely

/var/lib/mysql

Just deployed

/data

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

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. 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 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.


Template Content

More templates in this category

View Template
Pixelfed
Explore + Share beautiful photos and videos on the Fediverse

Evan Boehs
30
View Template
Hexo
Hexo — fast static blog framework with admin editor and S3 media storage

INAPP
2
View Template
Castopod
Self-hosted podcast hosting with Fediverse support

INAPP
1