InvoiceShelf/InvoiceShelf
Open Source Invoicing Solution for Individuals & Businesses
About InvoiceShelf/InvoiceShelf
InvoiceShelf/InvoiceShelf is an open-source project on GitHub, mainly written in PHP. Open Source Invoicing Solution for Individuals & Businesses It currently holds 1,974 stars and 413 forks with 84 open issues, and was last pushed on 2026-10-28 (repository created 2024-01-26).
Project Overview
Git Homed tracks it on the Today's Trending board, currently at rank #99 with 22 new stars today.
GitHub Repository Details
README
Open-source invoicing for people who want to own their business data.
Download InvoiceShelf · Try the live demo · Documentation · Join Discord
[!WARNING]
The default 3.x branch is an alpha preview. It is ready for testing and
feedback, but not for production data. Use the supported
2.x release for a
production installation.
Run your invoicing from one place
InvoiceShelf is a self-hosted web application for creating invoices, tracking payments and expenses, and keeping customer accounts organised. It is built for freelancers and small businesses that want a focused workflow without giving up control of their data.
Want to look around before installing? The public demo includes sample data and resets automatically.
- Create invoices and estimates, then export polished PDFs.
- Record payments and see what each customer still owes.
- Track expenses, taxes, and business reports.
- Schedule recurring invoices for repeat work.
- Give customers a portal for invoices, estimates, and payment history.
- Manage multiple companies and invite team members with scoped roles.
- Issue EN 16931 e-invoices: ZUGFeRD / Factur-X PDFs with the e-invoice XML
Optional official modules can add specialised features without making the core application heavier.
E-invoicing
InvoiceShelf 3.x issues e-invoices to the European standard EN 16931 through the official E-Invoicing module:
- An invoice's PDF becomes a ZUGFeRD / Factur-X hybrid e-invoice, a
- The XML can also be downloaded on its own, for portals that take a file.
- Each invoice shows whether it qualifies and, if not, exactly what is missing.
- Tax types carry their EN 16931 tax category and units their UN/ECE unit code.
Install InvoiceShelf
Production: InvoiceShelf 2.x
Install the current stable release from the
self-hosted download page, or run the
official Docker image with the :latest tag. Follow the
installation guide for the
complete setup and upgrade instructions.
Preview: InvoiceShelf 3.x
Use the preview only with disposable or backed-up data:
- Download the latest 3.x preview from the
- For Docker, use
invoiceshelf/invoiceshelf:nextinstead of:latestin the
A minimal SQLite Docker setup looks like this:
git clone https://github.com/InvoiceShelf/docker.git invoiceshelf
cd invoiceshelf
cp docker-compose.sqlite.yml docker-compose.yml
For the 3.x preview, change the image tag in docker-compose.yml to :next.
docker compose up -d
Open and finish the setup wizard. Read the Docker guide before using InvoiceShelf on a public server.
For a traditional web-server installation, see the manual installation guide. InvoiceShelf 3.x requires PHP 8.4 or 8.5 and supports MySQL/MariaDB, PostgreSQL, and SQLite. Docker includes the required application runtime.
Learn and get help
- User and installation documentation
- API reference
- Discord community
- Bug reports and feature requests
Contribute
Code contributions are welcome. Start with the
contribution guide and use the development environment in
docker/development.
You can also help translate InvoiceShelf on Crowdin.
License
InvoiceShelf is released under the GNU Affero General Public License v3.0.