TaxHacker for Cloudron

This repository contains the Cloudron package for TaxHacker, a self-hosted AI accounting app for receipts, invoices, and transaction analysis.

Package Overview

• Runs the upstream TaxHacker app in self-hosted mode.
• Protects access with Cloudron proxyAuth.
• Uses the Cloudron postgresql addon for the application database.
• Uses the Cloudron localstorage addon for persistent uploads and generated preview files.
• Persists the TaxHacker auth/encryption secret in /app/data/better_auth_secret.

Runtime Layout

• App code lives in /app/code/upstream.
• Persistent app data lives in /app/data.
• Uploaded files and generated previews live in /app/data/uploads.
• The package starts TaxHacker on internal port 7331.
• Database migrations run automatically on startup.
• Email sync runs inside the same container as a background loop.

Notes

• TaxHacker self-hosted mode uses a single internal application user.
• Cloudron proxyAuth is expected to provide the outer access control layer.
• The package uses Cloudron Postgres instead of the upstream bundled database container.
• The package does not write runtime state into /app/code.

Upstream Project

• Upstream repository: vas3k/TaxHacker
• Upstream application site: taxhacker.app