---
title: "Deploy TaxHacker"
description: "Self-hosted AI accounting: scan receipts and invoices with an LLM"
category: "AI/ML"
url: https://railway.com/deploy/taxhacker-2
---

# Deploy TaxHacker

Self-hosted AI accounting: scan receipts and invoices with an LLM

**[Deploy TaxHacker on Railway](https://railway.com/template/taxhacker-2)**

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

- **Creator:** Agaz Self-Host
- **Category:** AI/ML
- **Total deploys:** 2

## Template content

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

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

### TaxHacker https://raw.githubusercontent.com/vas3k/TaxHacker/main/public/logo/512.png

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

## Documentation

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



## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

Open this page in a browser: https://railway.com/deploy/taxhacker-2
