Getting Started

This guide walks you through installing Kitted, completing first-run setup, and activating your licence.

Installation

Download the installer for your platform from the Download page. Kitted is available for Windows, macOS, and Linux.

Run the installer and follow the prompts. No administrator privileges are required on Windows or macOS. On Linux, make the AppImage executable (chmod +x) and run it directly.

First Launch

When you open Kitted for the first time, you will be taken through a short setup wizard before anything else. This only runs once.

1. Business details

Enter your business name - this appears on the dashboard and in reports. You can change it later in Settings.

Select your currency. This controls how monetary values are formatted throughout the app. Changing the currency after you have entered prices does not convert existing values, so choose the right one now.

Select a business profile. This adjusts some default labels and terminology:

• Manufacturer - general manufacturing, discrete parts (Assemblies & Components)
• Food producer - recipe-based production with batch quantities (Recipes & Ingredients)
• Craft business - handmade goods, mixed batch and one-off production (Formulas & Materials)

2. Default location

Give your first stock location a name, for example Main Warehouse or Workshop. This is where stock will be counted by default. You can add more locations later in the Locations section.

3. Admin password

Set the password for the admin account.

If you’re the only user on this machine: you’ll never see this password again in normal use. Kitted signs you in automatically when you open the app on the machine it’s installed on. The password is only ever asked for when someone connects from another device on your network.

Minimum 8 characters. Keep it somewhere safe if you plan to allow network access.

4. Demo data (optional)

After setup completes you will be offered the chance to load demo data. This populates the app with example stock items, suppliers, sales, and production orders so you can explore without entering your own data first. Demo data can be wiped later from Settings → Data.

Your Data Directory

Kitted stores everything - the database, backups, and attachments - in a single folder on your machine. The default location is:

You can change this from Settings → Data Directory. The app will offer to copy your existing data to the new location. See Data Directory for full details.

Activating Your Licence

Kitted runs in trial mode until you activate a licence key. In trial mode all features are available, but a banner is shown as a reminder.

To activate:

1. Go to Settings → Licence
2. Paste your licence key into the field and click Activate
3. The app contacts the licence server to validate the key and register this machine

Activation requires an internet connection. Once activated, normal use is fully offline - the app only contacts the licence server for periodic check-ins in the background.

If you need to move Kitted to a new machine, deactivate on the old machine first via Settings → Licence → Deactivate, then activate on the new machine. See Licence Activation for more detail.

What’s Next

Once setup is complete you will land on the Dashboard, which shows a summary of recent activity and any low-stock alerts.

A good starting point is to add your stock items - head to Stock Items and either add them one by one or use the CSV Import to bulk-load from a spreadsheet.

Once you have data you care about, set up automatic backups in Settings → Backup so you always have a recent copy of your database. See Backup and Restore for details.