Deploy and Host Akaunting on Railway

What is Akaunting?

Akaunting is open-source accounting software for small businesses and freelancers. It provides invoicing, expense tracking, banking, reporting, and multi-company bookkeeping through a browser-based interface.

About Hosting Akaunting

This template deploys exactly two services: Akaunting and MariaDB. Akaunting uses akaunting/akaunting:3.1.21@sha256:918bbc77981e5b96ab6aa6838491cfa7c98cb4ee7bbf9532ee083e7e66d04255, and MariaDB uses mariadb:11.8.2@sha256:2bcbaec92bd9d4f6591bc8103d3a8e6d0512ee2235506e47a2e129d190444405. Railway provides the public HTTPS endpoint for Akaunting while MariaDB remains on private networking. Only MariaDB has a persistent volume, mounted at /var/lib/mysql; Akaunting has no volume mount. Shared credentials are generated once and passed through Railway service references. The deployer supplies only the initial administrator email and password.

Common Use Cases

Send invoices and track customer payments.
Record expenses, bills, banking activity, and transfers.
Run reports and maintain books for one or more small businesses.

Dependencies for Akaunting Hosting

akaunting/akaunting:3.1.21@sha256:918bbc77981e5b96ab6aa6838491cfa7c98cb4ee7bbf9532ee083e7e66d04255.
mariadb:11.8.2@sha256:2bcbaec92bd9d4f6591bc8103d3a8e6d0512ee2235506e47a2e129d190444405 on Railway private networking.
One persistent volume mounted at /var/lib/mysql for MariaDB; Akaunting has no volume mount.

Deployment Dependencies

Implementation Details

The Akaunting service listens on public port 80. Railway routes HTTPS to that port and checks /auth/login for application health. MariaDB is private-only and persists its database files at /var/lib/mysql.

The Akaunting service reaches MariaDB through ${{MariaDB.RAILWAY_PRIVATE_DOMAIN}}. MariaDB owns the authoritative generated database password; Akaunting references it without copying a literal value. The application signing key is generated once on Akaunting.

Because Akaunting has no volume mount, files written only to its container filesystem are outside this template's persistence guarantee and should not be assumed durable across container replacement. MariaDB data is persistent only through the volume mounted at /var/lib/mysql.

Before updating, back up the MariaDB volume, separately export any required Akaunting container-local files, review Akaunting and MariaDB release notes, and validate the replacement immutable image digests in isolation. If a database migration is incompatible, restore a MariaDB backup that matches the prior application and database pins; rolling back only the Akaunting image may not reverse a database migration.

This community template is maintained independently and does not imply affiliation with or endorsement by Akaunting.

Why Deploy Akaunting 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 Akaunting 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.