BETAAuraPOS is in active development. Not intended for critical production use.Learn more →
← Back to documentation

First steps — configuration wizard

On the very first launch of AuraPOS, a 5-step wizard walks you through the essential settings. These choices determine the applied VAT rates, the expected business identifier format, the available languages and the installation mode (single- or multi-register).

Step 1 — Country

Choose your shop's country among: Belgium, France, Netherlands, Luxembourg, Germany, Switzerland.

This choice automatically pre-fills:

  • the VAT rates (BE: 0/6/12/21, NL: 0/9/21, LU: 0/3/8/14/17, etc.)
  • the currency (EUR for BE/NL/LU/FR/DE, CHF for Switzerland)
  • the available languages (BE: fr/nl/en/de, NL: nl/en/fr, LU: fr/de/en, etc.)
  • the expected VAT format (BE0123456789, NL123456789B01, etc.)
  • the country-specific Peppol schemes

⚠️ The country also determines the business identifier label: CBE in Belgium, KvK in the Netherlands, RCS in Luxembourg, SIREN in France, Handelsregister in Germany.

Step 2 — Shop identity

Fill in your shop's legal information:

  • Shop name (required) — printed on receipts and invoices
  • Address, postal code, city
  • VAT number — in your country's format (validated automatically)
  • Business number (CBE/KvK/RCS depending on the country)
  • Phone and email
  • Receipt footer message (e.g. "Thank you for your visit!")

All this information will be printed on receipts and used in Peppol invoices (once the module is enabled in the stable version).

Step 3 — Installation mode

Three options:

Single-register (recommended to start)

A single register. Local SQLite database in %AppData%\AuraPOS\AuraPOS.db. No network configuration required. This is the simplest mode.

Multi-register — Master

This register hosts the PostgreSQL server and shares its data with the other registers in the shop. It must have a fixed IP address on the local network. PostgreSQL must be installed (the installer can do this automatically).

Multi-register — Slave

This register connects to a master register's PostgreSQL server. You'll need to enter the master's IP address. All data (products, customers, sales) is shared in real time.

Step 4 — Languages

Check the languages you want to enable in the interface. The default language is pre-selected based on the country. Users can switch languages at any time from the register menu.

Step 5 — Confirmation

A summary of your choices is shown. Click Finish to apply the configuration and launch AuraPOS.

Modifying settings later

All these choices can be modified later from Settings:

  • Shop tab: name, address, VAT, CBE, etc.
  • Storage tab: switch from single to multi-register
  • Languages tab: add/remove languages

⚠️ Changing the country afterwards does NOT update the VAT rates already entered on existing products: you must check them manually.