Gestion is a Nextcloud business management and invoicing application designed for freelancers, micro-enterprises, and small businesses. It helps you manage customers, products, quotes, invoices, and business activity directly from your Nextcloud instance.

Want to support the project? Buy the maintainer a coffee.

Translations are maintained with help from the Transifex team. Thank you to everyone who contributes to making the application available in multiple languages.

• Manage customers and their billing details.
• Manage a catalog of products or services.
• Create PDF quotes.
• Create and convert invoices as PDFs.
• Generate Factur-X electronic invoices.
• Send PDFs by email from the application.
• Store generated documents in Nextcloud Files.
• Configure company details, legal notices, VAT, currency, and numbering prefixes.
• Track business activity with statistics screens.
• Share invoicing configurations with other Nextcloud users.

According to the app metadata, Gestion targets:

• PHP 8 or newer;
• Nextcloud 31 to 34;
• a Nextcloud-compatible database, such as MariaDB/MySQL or PostgreSQL.

The main dependencies are managed with Composer for PHP and npm/Webpack for JavaScript and CSS assets.

For a standard installation on an existing instance:

1. Log in to Nextcloud with an administrator account.
2. Open Apps.
3. Search for Gestion.
4. Install and enable the application.
5. Open the application from the Nextcloud menu and complete your company configuration.

From the apps directory of your Nextcloud instance:

git clone https://github.com/baimard/gestion.git gestion
cd gestion
php composer.phar install --prefer-dist
npm install
npm run build

Then enable the app with occ:

php occ app:enable gestion

If you run these commands inside the official Nextcloud Docker container, run occ as the web server user:

su -s /bin/bash www-data -c 'php occ app:enable gestion'

The following example creates a development Nextcloud instance with MariaDB and mounts the local repository into the Nextcloud apps directory. It is intended for local development only, not for production.

• Docker;
• Docker Compose v2 (docker compose);
• Git;
• Node.js 20 and npm 10 if you build assets from the host;
• PHP 8 if you install Composer dependencies from the host.

From the repository root, create a temporary compose.yaml file:

services:
  db:
    image: mariadb:11
    command: --transaction-isolation=READ-COMMITTED --binlog-format=ROW
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: nextcloud
      MYSQL_ROOT_PASSWORD: nextcloud
    volumes:
      - db:/var/lib/mysql

  nextcloud:
    image: nextcloud:31-apache
    restart: unless-stopped
    ports:
      - "8080:80"
    depends_on:
      - db
    environment:
      MYSQL_HOST: db
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: nextcloud
      NEXTCLOUD_ADMIN_USER: admin
      NEXTCLOUD_ADMIN_PASSWORD: admin
    volumes:
      - nextcloud:/var/www/html
      - ./:/var/www/html/apps/gestion

volumes:
  db:
  nextcloud:

The ./:/var/www/html/apps/gestion volume makes local code changes immediately visible inside the Nextcloud container. The compose.yaml file can remain local if you do not want to commit it.

docker compose up -d

Wait for the automatic installation to finish, then open http://localhost:8080. The development credentials used in this example are:

• username: admin;
• password: admin.

You can install dependencies from the host:

php composer.phar install --prefer-dist
npm install
npm run build

Or from the Nextcloud container:

docker compose exec nextcloud bash -lc 'cd /var/www/html/apps/gestion && php composer.phar install --prefer-dist'
docker compose exec nextcloud bash -lc 'cd /var/www/html/apps/gestion && apt-get update && apt-get install -y nodejs npm && npm install && npm run build'

docker compose exec --user www-data nextcloud php occ app:enable gestion

If needed, also run Nextcloud repair and migration tasks:

docker compose exec --user www-data nextcloud php occ maintenance:repair

To work on JavaScript/CSS files:

npm run watch

Or, from the container:

docker compose exec nextcloud bash -lc 'cd /var/www/html/apps/gestion && npm run watch'

Stop containers without deleting data:

docker compose down

Also delete development volumes:

docker compose down -v

After installing dependencies:

vendor/bin/phpunit --colors=always --testdox

UI tests may require Firefox, GeckoDriver, and a properly initialized Nextcloud test instance. The protocole_tests.sh script documents a historical scenario for starting MariaDB/Nextcloud containers and loading test datasets.

1. Open or pick a GitHub issue.
2. Create a dedicated branch from master.
3. Preserve the PHP 8+ and Nextcloud compatibility declared in appinfo/info.xml.
4. Install dependencies and run the relevant tests.
5. Submit a pull request that clearly describes the change, tests performed, and any potential impact.

Please avoid editing generated translation files directly when the change should go through Transifex.

Gestion is distributed under the AGPL-3.0-or-later license. See COPYING for the full license text.