
Deploy TaxHacker
Self-hosted AI accounting: scan receipts and invoices with an LLM
Just deployed
/var/lib/postgresql/data
TaxHacker
Just deployed
/app/data
Deploy and Host TaxHacker on Railway
TaxHacker is an open-source, self-hosted accounting app for freelancers and small businesses. You upload receipts, invoices and bank statements, and an LLM (OpenAI, Google Gemini, Mistral or an OpenAI-compatible endpoint) pulls out dates, amounts, merchants, categories and line items into a searchable transaction list. Prompts, categories and fields are all customisable.
About Hosting TaxHacker
TaxHacker is a Next.js app that keeps its data in PostgreSQL and uploaded files on disk. In self-hosted mode it has no login screen, so this template puts a Caddy basic-auth gate in front of it: the username defaults to admin and the password is generated on deploy. The service runs the official TaxHacker 0.8.5 image, pinned by digest, and applies database migrations on start. Uploads and the session secret live on a volume at /app/data. Upstream's separate email-sync cron job runs inside the same service. Updates reach you as "update available" notices from the template repo.
Common Use Cases
- Scan receipts and invoices with an LLM and turn them into categorised transactions
- Keep a private, self-hosted record of income and expenses for tax returns, in any currency (including crypto)
- Import bank CSV exports, generate simple invoices and export transactions with their files for your accountant
Dependencies for TaxHacker Hosting
- PostgreSQL (included in the template)
- An API key for an LLM provider (OpenAI, Google Gemini, Mistral or an OpenAI-compatible endpoint), entered in the app's settings after deploy
Deployment Dependencies
- TaxHacker source and docs: https://github.com/vas3k/TaxHacker
- Template repo (Dockerfile, Caddy wrapper, changelog): https://github.com/aalfath/taxhacker-railway-template
Implementation Details
After deploy, open the TaxHacker service's Variables tab and copy TAXHACKER_PASSWORD. Then open your public domain and sign in as admin (or the TAXHACKER_USERNAME you set). On first visit, pick your default currency, then go to Settings → LLM settings and paste your provider API key. /healthz answers without a login so Railway can run health checks; every other path needs the password. Change the password at any time by editing TAXHACKER_PASSWORD and redeploying.
Why Deploy TaxHacker 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 TaxHacker 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

