---
title: "Deploy InvoiceShelf"
description: "Open-source invoicing: invoices, estimates, recurring billing, payments"
category: "Other"
url: https://railway.com/deploy/invoiceshelf-1
---

# Deploy InvoiceShelf

Open-source invoicing: invoices, estimates, recurring billing, payments

**[Deploy InvoiceShelf on Railway](https://railway.com/template/invoiceshelf-1)**

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

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

## Template content

### InvoiceShelf https://raw.githubusercontent.com/InvoiceShelf/InvoiceShelf/2.4.7/public/favicons/android-chrome-512x512.png

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

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host InvoiceShelf on Railway

InvoiceShelf is an open-source invoicing app for freelancers and small businesses. It creates invoices, estimates and recurring invoices, records payments and expenses, sends documents by email as PDFs, and gives customers a portal to view their documents. It is a self-hosted fork of Crater, licensed AGPL-3.0.

## About Hosting InvoiceShelf

InvoiceShelf is a Laravel app served by nginx and PHP-FPM in its official Docker image, with a SQL database and a storage folder for uploads, logos and PDF templates. This template builds InvoiceShelf 2.4.7 from a small GitHub wrapper around the official image, pinned by digest, and adds Railway Postgres and a volume for storage. On first boot it runs the migrations, seeds the database and removes the seeded default password, so the setup wizard opens at the domain step without asking for database details. The built-in scheduler generates recurring invoices. Finish the wizard right after deploying: until then, whoever opens the URL first can complete it.

## Common Use Cases

* Sending invoices and estimates to clients as PDFs or by email, with a customer portal
* Recurring invoices for retainers and subscriptions, generated by the built-in scheduler
* Tracking payments, expenses and taxes across one or more companies

## Dependencies for InvoiceShelf Hosting

* PostgreSQL (Railway Postgres, included)
* A volume for `/var/www/html/storage` (included)

### Deployment Dependencies

* InvoiceShelf on GitHub: https://github.com/InvoiceShelf/InvoiceShelf
* InvoiceShelf 2.4.7 release notes: https://github.com/InvoiceShelf/InvoiceShelf/releases/tag/2.4.7
* Official Docker image: https://hub.docker.com/r/invoiceshelf/invoiceshelf
* Template source: https://github.com/aalfath/invoiceshelf-railway-template

### Implementation Details

After the deploy finishes, open the public URL and finish the wizard: confirm the domain, pick a mail driver (choose "Log" to skip email for now), create your admin account, then add your company and its currency and time zone. Your account is the only login.

For a custom domain, update `APP_URL`, `SANCTUM_STATEFUL_DOMAINS` and `SESSION_DOMAIN` on the InvoiceShelf service. For email that survives redeploys, set `MAIL_MAILER`, `MAIL_HOST`, `MAIL_PORT`, `MAIL_USERNAME`, `MAIL_PASSWORD`, `MAIL_FROM_ADDRESS` and `MAIL_FROM_NAME` as service variables. Updates arrive as pinned version bumps in the template repo; the migrations run on start.

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

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/invoiceshelf-1
