Introduction

Annuva is a self-hostable billing and profitability dashboard for freelancers and small agencies who sell recurring services – hosting, domains, maintenance – next to their project work. It keeps customers, recurring charges, fixed costs, expenses, resources, offers and invoices in one place and answers the questions a spreadsheet makes hard:

• What did I earn this year?
• What is coming in and going out next month?
• Which customer is actually worth it?
• How much tax should I put aside?

What you get#

• Dashboard with revenue, expenses, result, cash flow, tax estimate and a rating for every customer
• Recurring charges (monthly to yearly) and a billing run that turns everything due into invoice drafts
• Invoices with gapless numbers, PDF templates, small-business taxation (§ 19 UStG) or VAT per line, cancellations, e-mail delivery and reminders
• Fixed costs, expenses, resources, offers and tasks around each customer
• A REST API with personal tokens and an MCP server, so AI assistants can work with your data
• German and English, light and dark theme, works on every screen size

How it runs#

Annuva is a single Docker container. Without any configuration it starts with an SQLite database in a data folder; MySQL and PostgreSQL are supported as well. A setup wizard creates the first administrator and your company data on the first start.

Annuva is free software under the GNU AGPL-3.0. The source code lives on GitHub.

Where to go next#

1. Installation – run Annuva with Docker in a few minutes
2. Configuration – every environment variable with its default
3. First start – the setup wizard step by step
4. Concepts – how amounts, invoices, the billing run and the customer rating work
5. AI assistants (MCP) – connect Claude, Cursor or VS Code to your instance

Just want to look around? The demo shows Annuva with sample data.