SolidInvoice

The open-source invoicing platform for freelancers and small businesses.

Send beautiful quotes and invoices, accept online payments, automate recurring billing — and own every byte of your data.

---

Why SolidInvoice?

Most invoicing tools force a trade-off: easy to use or respectful of your data. SolidInvoice gives you both. It's a mature, production-ready billing platform you can run on your own server for free, or let us host for a flat $8/month — no per-client limits, no surprise tiers, no lock-in. Built on Symfony 7 and PHP 8.4, it's designed to be extended, integrated, and trusted.

---

✨ Features

💼 Billing & Invoicing

• Quotes that convert into invoices in one click
• Recurring invoices on flexible schedules
• Multi-currency support (real Money objects — no float rounding)
• Multi-tax support with invoice-level tax and automatic rate snapshot on issue
• Flat-rate and percentage tax types, plus per-line discounts
• 8 built-in PDF templates for invoices and quotes
• Automatic overdue detection with configurable notifications
• Payment reminders sent on a schedule you define
• Create a new client directly from the invoice or quote form
• Invoice state machine (draft → pending → paid)

👥 Clients & Contacts

• Full client and contact management
• Custom fields for clients and contacts
• Per-client currency, addresses and contact channels
• Multi-tenancy out of the box (run multiple companies from one install)

🔐 User & Security

• Two-Factor Authentication (2FA) via TOTP
• Google OAuth login
• User email verification
• Role-based access control with Symfony Security & Voters
• Guided onboarding flow with a checklist for new users

💳 Payments

• Bring-your-own Stripe, PayPal and other gateways via Payum
• Online payment links sent with invoices
• PCI-compliant — no card data ever touches your server

🔌 Integrations & API

• REST API (JSON-LD, JSON-HAL, JSON, XML) powered by API Platform 4
• Token-based auth (X-API-TOKEN)
• Built-in MCP server with OAuth2 for AI agent automation
• Meilisearch integration for fast full-text search across all data
• Grid export and full company data export
• Notifications via email, SMS and chat channels

🛡 Privacy & Ownership

• 100% self-hostable — your database, your rules
• Encrypted secrets, Doctrine multi-tenancy filters
• MIT licensed — fork it, modify it, ship it

🚀 Modern Stack

• Symfony 7.1, PHP 8.4, Doctrine ORM, API Platform 4
• Tabler UI on Bootstrap 5.3 — fully responsive, mobile-friendly
• Stimulus, Webpack Encore, Bun, Sass
• Helm charts for Kubernetes, opt-in Prometheus metrics
• Symfony Messenger for async task processing
• ULID primary keys, PHPStan level 6, ECS, Rector

---

🏠 Self-Hosted vs. ☁️ Hosted

Both versions ship the same codebase and feature set. Pick whichever fits your workflow.

	🏠 Self-Hosted (Free, MIT)	☁️ Hosted ($8/month)
Price	Free forever	Flat $8/mo — no per-client fees
Setup	You install & maintain	Zero setup — sign up and send
Updates	Manual	Automatic
Backups	You manage	Daily, managed for you
Branding	Yours	SolidInvoice branding removed
Early access to new features	—	✅
Data ownership	Full	Full — export anytime
Best for	Tinkerers, privacy-first teams	Anyone who wants to invoice today

---

📸 Screenshots

Dashboard	Client View
Invoice List	Invoice Editor
Recurring Invoices	Payments

---

🚀 Quick Start

Option 1 — Hosted (recommended)

The fastest way to start sending invoices. Sign up at solidinvoice.co — no install, no server, automatic updates and backups for $8/month.

Option 2 — Docker

docker run -p 8080:80 solidinvoice/solidinvoice

Full image and configuration options: hub.docker.com/r/solidinvoice/solidinvoice

Option 3 — Single binary or Homebrew

Get up and running in seconds with a self-contained binary — no PHP, no web server, no extensions to install.

macOS / Linux (Homebrew):

brew install solidworx/tap/solidinvoice
solidinvoice run

Direct binary download:

Grab the latest binary for your platform from the releases page, make it executable, and run it:

chmod +x solidinvoice
./solidinvoice run

That's it — open http://localhost:8765 and you're invoicing.

Option 4 — From source (for developers)

git clone https://github.com/SolidInvoice/SolidInvoice.git
cd SolidInvoice
composer install
bun install && bun run dev

For production builds:

bun run build

Requirements: PHP 8.4+, ext-curl, ext-gd, ext-intl, ext-openssl, ext-pdo, ext-soap, ext-xsl, MySQL/MariaDB or PostgreSQL.

---

🛠 Tech Stack

Backend: Symfony 7.1 · PHP 8.4 · Doctrine ORM · API Platform 4 · Payum · MoneyPHP Frontend: Tabler · Bootstrap 5.3 · Stimulus · Webpack Encore · Bun · Sass Quality: PHPStan (level 6) · ECS · Rector · PHPUnit · Foundry · GitHub Actions

---

📚 Documentation

• 🌐 Website — solidinvoice.co
• 📖 Docs & guides — solidinvoice.co/docs
• 🔄 Upgrading — UPGRADE.md
• 📝 Changelog — CHANGELOG.md

---

💬 Feedback

Using SolidInvoice, hosted or self-hosted? Tell us what works, what gets in your way, and what's missing in our 5-minute feedback form. It's anonymous and every question is optional.

---

🎁 Refer & Earn

Earn up to $93 a year for every customer you refer to SolidInvoice Cloud. Join the affiliate program, share your link, and earn 20% of every payment your referrals make, month after month. Self-hosted users can take part too.

---

🤝 Contributing

We love contributions of every shape — code, docs, translations, bug reports, ideas. Look for the good first issue label to get started, then read the contributing guide and our code of conduct.

---

🔒 Security

Found a vulnerability? Please do not open a public issue. See SECURITY.md for our responsible disclosure process.

---

💖 Sponsors & Acknowledgements

SolidInvoice is built and maintained thanks to our sponsors. Want to support the project? Become a sponsor.

A huge thank-you to:

• JetBrains — PhpStorm licenses
• Docker — Docker Hub subscription
• Sentry — Sponsored Business plan

---

📄 License

SolidInvoice is open-source software released under the MIT License.

---

Website · Hosted · Docs · Releases · Sponsor

Made with ❤️ by SolidWorx and contributors.