# Invoiceplane

Initial setup with `services.invoiceplane.sites.<name>.database.createLocally`
requires manual editing of `ipconfig.php`, to allow creation of the first admin user.
Access to the database is provided via socket + matching unix username, which
means there is no password. During the invoiceplane setup in the Web UI,
filling the invoiceplane database form does not work, because a password will be
required.

First change these environment variables to `false`, then go to https://invoicing.momo.koeln/setup.

```
services.invoiceplane.sites."invoicing.${config.momo-cloud.networking.domain}" = {
  settings = {
    DISABLE_SETUP=false;
    SETUP_COMPLETED=false;
  };
};
```

Before continuing the setup wizard in the Web UI, SSH into the server and edit
`/var/lib/invoiceplane/invoicing.momo.koeln/ipconfig.php`

```
momo in 🌐 pioneer in ~
sudo vim /var/lib/invoiceplane/invoicing.momo.koeln/ipconfig.php
```

Set the following environment variables:

```
DB_USERNAME='invoiceplane'
DB_DATABASE='invoiceplane'
```

This will allow to click through the setup wizard without having to fill in
anything. After database migrations have run, you will be prompted to create
the first admin user.

Source: https://wiki.nixos.org/wiki/Invoiceplane