Darko Gjorgjijoski
f308ed9181
CI checkouts have no .env, so the backup-and-restore pattern in the installation and set-domain tests fatally failed on the first read. The tests now seed .env from .env.example when absent, the way an installer would, and remove it again afterwards. Developer machines are unaffected.
Open-source invoicing for people who want to own their business data.
Download InvoiceShelf · Documentation · Join Discord
Warning
The default
3.xbranch is an alpha preview. It is ready for testing and feedback, but not for production data. Use the supported2.xrelease 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.
- 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.
Optional official modules can add specialised features without making the core application heavier.
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 self-hosted download page.
- For Docker, use
invoiceshelf/invoiceshelf:nextinstead of:latestin the official Compose setup.
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 http://localhost:8090 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 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.