Troubleshooting

Try right-clicking the icon and selecting "Run as administrator". If that doesn't work, check that you have the Visual C++ Redistributable installed (download from Microsoft's website). If the app crashes immediately, check the logs at %APPDATA%\Nventory\logs\.

If using the AppImage: make sure it has execute permission (chmod +x Nventory-linux.AppImage). If you see a FUSE error, install libfuse2: sudo apt install libfuse2. For .deb installs, run sudo apt -f install to fix missing dependencies.

The activation step requires a brief internet connection. Check your internet, then try again. If you see "Key not found", double-check you copied the key correctly from the email — all caps, no extra spaces. If you see "Seats exhausted", contact us to free a seat.

Check that the LAN Sync Server is running on the hub machine (look for the tray icon). Verify all machines are on the same network. Make sure your firewall or antivirus is not blocking port 4001. Try pinging the hub IP from a till: open a terminal and run ping 192.168.1.10 (replace with your hub's IP).

Nventory supports USB HID barcode scanners out of the box — they work like a keyboard. Make sure the POS screen is focused (click on it) before scanning. Bluetooth scanners must be paired to the machine via the OS settings first.

Go to Settings → Receipts → Printer. Select your printer from the list. If it doesn't appear, make sure it's installed in the OS (Windows: Devices & Printers; Linux: CUPS). For thermal receipt printers, install the manufacturer's driver. Test with a Windows/Linux test print first.

Check the original purchase email from LemonSqueezy — search your inbox for "Nventory" or "LemonSqueezy". If you still can't find it, contact us at support@nventory.app with the email address you used to purchase and we'll resend it.