8000
Skip to content

Latest commit

Β 

History

5,313 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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.

License: MIT Latest Release PHP 8.4+ Symfony 7 Docker Pulls GitHub Stars

Artifact Hub

Try Hosted Self-Host with Docker Star on GitHub

SolidInvoice Dashboard

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

Start with the hosted version β†’ solidinvoice.co


πŸ“Έ Screenshots

Dashboard
Dashboard
Client View
Client View
Invoice List
Invoice List
Invoice Editor
Invoice Editor
Recurring Invoices
Recurring Invoices
Payments
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


🀝 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.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages

0