Guides

Practical paths for operators and buyers — install, activate, choose a package, and understand offline-first POS on Linux and Windows.

Install on Linux

Dedicated install root, first launch, and where your ledger lives.

  • Prefer the .tar.gz + ./install.sh or the .deb so MiniBook3 owns its own folder
  • Do not unpack the inner bundle into a shared directory — in-app updates refuse unsafe parents
  • Launch from the applications menu or run minibook3 after install
  • Data stays on this machine (typically under ~/.local/share/MiniBook3/)
Laptop with code representing a Linux MiniBook3 install

Install on Windows

Installer, portable zip, and a clean path for updates.

  • Run the win64 setup — Next, Install, Finish opens MiniBook3 from Start Menu
  • Portable zip: extract into its own empty folder, then run minibook3.exe from there
  • Never unpack into a shared Programs root that also holds other apps
  • Ledger path: %LOCALAPPDATA%\MiniBook3\
Workstation analytics desk for Windows MiniBook3 setup

Activate your licence

Request a key, verify online, choose Free / Solo / Enterprise, open the register.

  • Free needs no payment — activate when online so the shop is recognised
  • Solo and Enterprise complete payment on minibook3.zolestio.com, then return to the app
  • If the cloud is briefly down, Free can still open the register offline; retry activate later
  • Same flow on Linux-MiniBook3 and Windows-MiniBook3 — one product language
Shop opening energy when activating MiniBook3

Devices & receipts

Printers, drawer kick, and branding that matches the till.

  • Linux: CUPS queues; Windows: RAW / Windows spooler printers
  • Cash drawer kick rides with the receipt printer when wired correctly
  • Paid packages unlock richer receipt branding for the store identity
  • Test print from Devices before the lunch rush — not during it
Connected devices and tech setup for the counter

Deep guides

Longer answers for search intent — offline POS, platform setup, and the Free / Solo / Enterprise ladder.

Busy service counter that keeps moving when the network drops

Buyer guide

How to choose an offline-first POS

Cloud tabs freeze when the line drops. An offline-first register keeps the lunch rush moving — if the product is honest about what lives on the till versus what waits for the network.

Read guide →

On the floor

Longer stories for day one and platform parity — same tokens and photography language as Features.

Your first sale in minutes

After install, the goal is simple: one clean sale that prints and closes. Everything else can wait.

  • Add a few SKUs or import a starter CSV on Solo+
  • Open a shift with a float you can count back
  • Ring a cash or card tender and confirm the receipt lands
  • Close the shift once — so Z-report numbers feel real on day one
Customer service moment representing a first successful sale

Linux and Windows, same playbook

Operators learn one product. Packaging differs; the register, shifts, and upgrade story do not.

  • Download the build that matches the desk — Linux-MiniBook3 or Windows-MiniBook3
  • Keep installs in dedicated folders so signed updates apply safely
  • Printer setup is OS-specific; everything above the device layer stays familiar
  • Fleet and portal features arrive with Enterprise — per PoS node
Planning desk for operators learning MiniBook3 guides

Keep nearby

Data, updates, and when the ladder makes sense — short reminders for busy operators.

Busy counter that keeps selling when the network drops

Where data lives

The ledger is local. Back up the data directory before moving PCs or wiping disks — the cloud never replaces that folder on Free/Solo.

Hands managing software updates on a device

Updates without drama

Signed channel releases for both platforms. Path-safe apply refuses to wipe a shared parent — that refusal is protection, not a bug.

Retail shop floor when the counter is ready to grow

When to upgrade

Stay Free while the counter is simple. Move to Solo for credits, team, and exports. Choose Enterprise when tills must move as one.

Answered questions

Edge cases that break real shops — answered before they break yours.

Do I need internet to sell?

No. MiniBook3 is offline-first. Network drops pause connected features; they do not freeze a sale already on the till. Free and Solo keep trading on the local ledger.

Where should I install so updates work?

Use a dedicated MiniBook3 folder (installer/deb/install.sh or a portable folder you own). Do not unpack into a shared Programs or projects root that also holds other apps — updates only replace files inside a verified install.

Linux vs Windows — which guide do I follow?

Follow the OS on the desk. Packaging and printers differ; activation, shifts, catalog, and package names stay the same so staff train once.

Activation failed or the licence cloud is down. What now?

Confirm the PC can reach api-minibook3.zolestio.com. Free shops can often open the register offline and retry activate later. Paid packages need a successful payment return before Solo/Enterprise entitlements stick — retry after the network recovers; do not re-pay blindly if the portal already shows success.

Receipts print blank or the drawer never kicks.

Verify the OS queue (CUPS or Windows spooler), paper width, and that the drawer cable is on the printer’s kick port. Run a test print from Devices. Branding richness follows the paid package — Free still prints a working receipt.

I moved the PC / wiped the disk. Where is my shop?

Restore the backed-up data directory for that OS. Reinstall the app, then point or restore into the expected path. Activation recognises the shop again when online; the ledger itself was always local.

Can one licence cover every till?

Free and Solo are single-node stories for one desk. Enterprise is licensed per PoS node when the floor needs connected fleet behaviour. See Pricing for the honest ladder.

Is this the same product as the old control-plane hosts?

Marketing and licence APIs live on minibook3.zolestio.com and api-minibook3.zolestio.com. Linux and Windows POS builds target those hosts. Until your cutover checklist is green, do not assume legacy hosts still serve MiniBook3.