Skip to content

First launch

The first time you open Fexl Lite after installing, the app walks you through three things in order — activating your license, setting an owner PIN, and filling in the basics about your store. Five minutes, in any order of importance: do them once, then never again.

Updated 5 May 2026·For v2.2.0·2 min read
getting-started · first-launch · welcome screen

What happens, in order

1

Activate the license

Paste the license key from your purchase email and click Activate. The app calls our license server once to verify and bind the key to this machine, then runs offline forever after. If you’re offline at first launch, click Skip for now — you can activate later from Settings → Security → License, but most features stay locked until you do.

2

Set the owner PIN

Choose a 4-6 digit PIN for the owner account. This is the first user; you can add staff users (and their own PINs) later from Settings → Security → Users. The owner PIN is also the master override — keep it private.

3

Fill in the store info wizard

A short form: store name, address, currency, language, time zone. Defaults are sensible — IQD currency and English language unless your license region overrides them. You can edit any of this later from Settings → General, so don’t agonise. The full reference for these fields is on Store setup.

4

Optional: load demo data

The wizard offers a Load demo data toggle on the last screen. It seeds 30-odd sample products across three categories, two demo customers, and one supplier — useful for clicking through the POS and reports before you have real inventory. You can wipe it later from Settings → System → Reset demo data; it’s tagged so a real backup will never overwrite your demo seed by accident.

getting-started · first-launch · store info wizard

Where your data lives

Fexl Lite is offline-first. Everything you enter is written to a local SQLite database on this machine, not the cloud — even if Cloud Sync is enabled, the local file is the source of truth and the cloud is a mirror.

  • macOS~/Library/Application Support/com.minib2c.pos/fexl.db
  • WindowsC:\Users\<you>\AppData\Roaming\com.minib2c.pos\fexl.db

The Tauri sidecar bundles a Go server that reads and writes this file; the app talks to it on localhost:8089. You don’t need to manage the server — it starts and stops with the app.