A complete walkthrough of the app with all 21 screens: from installing and creating your account to sending your first invoice, tracking payments and backing up.
The quickest route is one command: it installs Docker if you need it, downloads Mavri and starts it. Home-server users can install through CasaOS or ZimaOS.
Installs Docker Desktop and git with Homebrew if either is missing, then downloads and starts Mavri. No Homebrew yet? The script tells you how to get it.
Installs Docker Engine (official script) and git if either is missing, then downloads and starts Mavri. Safe to run again.
Sets up WSL2 with the Docker Engine, so no Docker Desktop, then downloads and starts Mavri. The first time, Windows may ask for one restart: restart and run the same command again.
Already have Docker and git? Run these instead:
git clone https://github.com/Raktim94/mavri.git
cd mavri
docker compose up -d --buildThen open http://localhost:3001. Full options: Get started · Install on CasaOS · Quick start with copy-paste commands.
Step 1 · 1 of 25
The first visit asks for an email and a password. This becomes the owner account, so keep the details safe. The form checks the password as you type: at least 8 characters, with letters and numbers.
Step 2 · 2 of 25
A short wizard follows: your business (with a logo if you have one), currency and bank details, and a first customer. Each step saves as you continue and every step can be skipped.
Home · 3 of 25
The dashboard shows four totals: Outstanding, Overdue, Billed this month and Collected, followed by your recent invoices with status badges. The left menu has three groups: Workspace, Records and System.
Records · 4 of 25
A business is who the invoice is from: name, address, email, phone, tax ID and logo. You can keep several businesses in one installation.
Records · 5 of 25
Customers are who you bill. Add an address, tax ID and country code for e-invoices, and a buyer reference if the customer requires one.
Records · 6 of 25
Products are things you sell, with a price, a category and a unit. Pick one when you make an invoice, or skip the catalog and type any line freely.
Records · 7 of 25
Categories group your products so a longer catalog stays tidy.
Records · 8 of 25
Units such as hour, day or piece appear on invoice lines next to the quantity.
Records · 9 of 25
Bank accounts hold the payment details printed on your invoices, so clients know how to pay you.
Records · 10 of 25
Common currencies are already there. Add others with their symbol and a format such as {symbol}{amount}.
Workspace · 11 of 25
The invoice list has status tabs with counts and flags for overdue invoices. Search by number or customer name, and open any invoice to see its payments.
Workspace · 12 of 25
Go to Invoices → New invoice. One page, in seven sections: customer, items, tax, dates and terms, payment, brand and notes, and a review, with a live preview beside it.
Workspace · 13 of 25
Templates has fifteen print layouts, from a plain ledger grid to GST, VAT and thermal receipts. Open one to see it with sample data, then choose Use this template.
Workspace · 14 of 25
Needs attention lists unpaid invoices that need a person today, most urgent first, with the reason and a suggested next step. On an invoice, record a promise to pay, a dispute or a pause.
Workspace · 15 of 25
Click a customer’s name for their page: what they owe by how late it is, their last invoice, payment and contact, open follow-ups and every invoice. For an EU customer, Check with VIES asks the European Commission’s service whether their VAT number is active.
Workspace · 16 of 25
Tax guidance shows what Mavri knows about India GST, UK VAT, EU VAT, UAE VAT and US sales tax, where each comes from, and what it does not cover. You can check a tax number too.
Workspace · 17 of 25
Open an invoice to see it as your client will. Print / save as PDF uses your browser’s print dialog: choose Save as PDF as the printer. UBL XML and XRechnung XML download electronic invoices.
Workspace · 18 of 25
Add each payment on the invoice. The status becomes Partly paid or Paid by itself, and a paid invoice shows the payment and a zero balance. Void cancels an invoice.
Workspace · 19 of 25
Quotes work like invoices. When a customer accepts, open the quote and choose Convert to invoice; the quote becomes Accepted.
Speed-ups · 20 of 25
A preset is a saved combination of business, customer, currency, bank and notes. Start a document from it to fill those fields in one step.
Speed-ups · 21 of 25
A style stores accent colour, font, text size, page size and which columns to show. Apply one to a document to copy that look.
Insight · 22 of 25
Reports add up billed, paid and outstanding amounts by month and by client for a chosen year, per currency.
Automation · 23 of 25
Stores connect a shop. Connect a store, then copy the webhook URL and the signing secret (shown once) into Shopify, WooCommerce or your own system. Each order becomes an invoice, exactly once.
System · 24 of 25
Settings holds invoice and quote number prefixes, and switches that hide features you do not use (quotes, presets, styles, reports, UBL and XRechnung export). It also has Backup, API keys and Updates.
UPDATE_CHECK=off, so it says checks are turned off.
Appearance · 25 of 25
Mavri follows your system’s light or dark preference. Printed invoices are always black on white with no animation.
