SolidInvoice

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 it: start on the Free plan, with paid plans from $9/month — no lock-in. Built on Symfony 8.1 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 8.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 run the same codebase. Self-hosted has no limits; hosted features depend on your plan. Pick whichever fits your workflow.

Start with the hosted version → solidinvoice.co

---

📸 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](https://solidinvoice.co) — no install, no server, automatic updates and backups. Start on the Free plan; paid plans start at $9/month.

Option 2 — Docker

docker run -p 8080:80 solidinvoice/solidinvoice

Full image and configuration options: [hub.docker.com/r/solidinvoice/solidinvoice](https://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 8.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](https://github.com/sponsors/SolidInvoice?o=esc).

A huge thank-you to:

• [JetBrains](https://www.jetbrains.com/) — PhpStorm licenses
• [Docker](https://www.docker.com/) — Docker Hub subscription
• [Sentry](https://sentry.io/) — Sponsored Business plan

---

📄 License

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

---

[Website](https://solidinvoice.co) · [Hosted](https://solidinvoice.co) · [Docs](https://solidinvoice.co/docs) · [Releases](https://github.com/SolidInvoice/SolidInvoice/releases) · [Sponsor](https://github.com/sponsors/SolidInvoice?o=esc)

Made with ❤️ by SolidWorx and contributors.