This guide seems to be broken for php version > 7.4, we would be happy if you want to work on a solution and create a Pull Request. See also the related issue:


InvoicePlane is a self-hosted open source application for managing your quotes, invoices, clients and payments.


For this guide you should be familiar with the basic concepts of


We’re using PHP in the stable version 7.4:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '7.4'
[isabell@stardust ~]$

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
[isabell@stardust ~]$

Your website domain needs to be set up:

[isabell@stardust ~]$ uberspace web domain list
[isabell@stardust ~]$


To install InvoicePlane we download the current version from the official website. cd to your DocumentRoot so the zip file will be under your html.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/
[isabell@stardust html]$ wget
[isabell@stardust html]$ unzip v1.5.11
[isabell@stardust html]$ rm v1.5.11
[isabell@stardust html]$


Create the database, copy the configuration template, rename the htaccess file and add your URL in the ipconfig.php file under IP_URL.

[isabell@stardust html]$ mysql -e "CREATE DATABASE ${USER}_ip"
[isabell@stardust html]$ cp ipconfig.php.example ipconfig.php
[isabell@stardust html]$ mv htaccess .htaccess
[isabell@stardust html]$

After the installation you need to open in your browser to finish your setup.

Fill out your system settings, admin user and edit the following database settings:
  • Username: isabell

  • Password from your MySQL credentials

  • Database: isabell_ip

Best practices


If you want to secure your installation, you may disable the setup for now. To do so, replace the line DISABLE_SETUP=false with DISABLE_SETUP=true in your ipconfig.php file.


Check InvoicePlane’s stable releases for the latest versions. If a newer version is available, you should manually update your installation.

Backup your ipconfig.php file, delete everything else in your html directory.

[isabell@stardust ~]$ cd /var/www/virtual/$USER/html/
[isabell@stardust html]$ cp ipconfig.php ~
[isabell@stardust html]$ rm -rf * .*

Proceed with the installation steps from here and move back your config file.

[isabell@stardust html]$ mv ~/ipconfig.php ./
[isabell@stardust html]$

Finish the update by open in your browser.

Tested with InvoicePlane 1.5.11 and Uberspace

Written by: Thomas Johnson <>