Skip to content
selfhostrPublic

About

Garage management for Swiss garages and dealerships: workshop, QR invoices, parts, sales. Self-hosted, Docker, MIT.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

703 Commits

Folders and files

Repository files navigation

dmsforall: garage management for Swiss garages

Self-hosted management software for Swiss garages and dealerships: repair orders, QR-bill invoices, parts, time clocking and used car sales.

Site · Docs · Demo · Changelog

CI License: MIT

Overview

dmsforall runs the workshop and the counter in one browser application: clients, vehicles, repair orders, appointments, time clocking, parts stock, quotes, invoices and payments. It is built for Swiss garages (QR-bill, VAT per line, amounts in whole centimes, French, German and Italian). Free, for good: MIT licence, no paid edition.

Quick start

curl -LO https://github.com/selfhostr/dmsforall/releases/latest/download/docker-compose.yml
docker compose up -d
docker compose logs api   # prints the one-time installation code

Open https://<server address>:8443 (the certificate is self-signed: accept it once). A new installation shows Create your garage: enter the garage name, your name, your e-mail address, a password and the installation code from the logs. You are signed in and the setup assistant opens. Without the browser, docker compose exec api node dist/cli/creer-garage.js --garage "Garage Exemple" --email direction@example.ch creates the garage from the command line. You need Docker with Compose v2. That one file is all you need: no clone, no other file, no folder to create. The passwords and keys are generated on the first start, your data lives in ./data and a daily backup is written to ./backups. Copy the backups off the server and test a restore before you enter real data: Back up and restore.

For a domain name with a real certificate, put your own reverse proxy in front, for example with Caddy, and set DFA_PUBLIC_URL=https://dmsforall.example.ch in a .env file:

dmsforall.example.ch {
  reverse_proxy https://127.0.0.1:8443 { transport http { tls_insecure_skip_verify } }
}

nginx (proxy_pass https://127.0.0.1:8443; proxy_ssl_verify off;) and Cloudflare tunnels (noTLSVerify: true) are covered in Install on a server.

Features

  • Clients and vehicles. Client records, contacts, vehicle owner history and a global search.
  • Workshop. Repair orders with labour, parts and fee lines, appointments and a courtesy car list.
  • Time clocking. Technicians clock their time on repair orders from a shared terminal protected by a PIN.
  • Invoicing. Quotes, invoices, down-payment invoices and credit notes, with a Swiss QR-bill and PDF output.
  • Payments. Cash, card, bank transfer, QR-bill, TWINT, compensation and leasing.
  • Parts and stock. Articles, stock per site, reservations, supplier orders and supplier invoices.
  • Car sales and tyres. Used and new car sales files, trade-ins, and seasonal tyre storage.
  • Import and export. Import from a Microsoft Access or dBase/FoxPro archive, WinBIZ accounting export.

Architecture

A React single-page application built with Vite calls a NestJS API that publishes an OpenAPI description. The API stores data in PostgreSQL 16 through Drizzle ORM, with row-level security on tenant tables. Valkey (Redis-compatible) and BullMQ run background jobs, and the web container serves the app over HTTPS and relays the API in the production Docker stack. More in the architecture page.

Limits

  • Alpha: the data model, the configuration variables and the screens can still change between releases.
  • Designed for Swiss law and VAT only, with French, German and Italian interfaces.
  • No tax or legal guarantee: have invoices and accounting exports checked by a fiduciary.
  • Connectors to third-party services need their own licences or accounts.
  • The operator is responsible for the HTTPS reverse proxy and certificate on a domain, copying the backups off the server, and updates.

Contributing

Issues and pull requests are welcome: CONTRIBUTING.md. Security issues: SECURITY.md.

License

MIT, see LICENSE. Provided "as is", without warranty of any kind.

Support

dmsforall is free and has no company behind it. If it saves you time: sponsor us on GitHub.

About

Garage management for Swiss garages and dealerships: workshop, QR invoices, parts, sales. Self-hosted, Docker, MIT.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages