Deploy InvoiceShelf
Open-source invoicing: invoices, estimates, recurring billing, payments
InvoiceShelf
Just deployed
/var/www/html/storage
Just deployed
/var/lib/postgresql/data
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.
Template Content
