Data Directory

The data directory is the folder where Kitted stores all of its persistent files: the database, uploaded images, attachments, backups, and the JWT secret used to sign login sessions.

What’s in the Data Directory

File / Folder	Purpose
`kitted.db`	The SQLite database - all your stock, orders, settings, and history.
`stock-items/`	Images uploaded for stock items.
`attachments/`	Documents and files attached to suppliers, stock items, and production orders.
`backups/`	Automatic and manual backup files (unless you set a custom backup destination).
`.jwt-secret`	Auto-generated on first run. Contains the secret used to sign login tokens. Do not delete or share this file.

The database is a single standard SQLite file. You can open it with any SQLite browser (e.g. DB Browser for SQLite) for inspection, though making manual edits is not recommended.

Default Location

The default data directory depends on your operating system:

Platform	Default path
Windows	`%APPDATA%\kitted` (typically `C:\Users\<you>\AppData\Roaming\kitted`)
macOS	`~/Library/Application Support/kitted`
Linux	`$XDG_DATA_HOME/kitted` (typically `~/.local/share/kitted`)

Changing the Data Directory

The current data directory path is shown in Settings → Data. To change it:

Click Change… next to the data directory path.
Enter the new absolute path. The directory will be created if it does not exist.
Click Apply. Kitted validates the path is writable, then saves the override.
Restart the application - the new path takes effect only after a restart.

The override is stored in a small config file outside the data directory so it survives the change:

Platform	Override config file
Windows	`%LOCALAPPDATA%\.kitted-config.json`
macOS / Linux	`~/.kitted-config.json`

After changing the data directory, your existing database and files remain in the original location. If you want to continue using that data, move the contents of the old directory to the new location before restarting.

Environment Variable Override

For headless or scripted deployments you can override the data directory with the DATA_DIR environment variable. This takes precedence over both the default and any UI-set override:

DATA_DIR=/var/data/kitted ./kitted

Individual paths can also be overridden independently:

Variable	Overrides
`DB_PATH`	Path to the SQLite database file.
`KITTED_IMAGES_PATH`	Path to the stock item images folder.
`KITTED_ATTACHMENTS_PATH`	Path to the attachments folder.

Opening the Folder

In Settings → Data, click Browse… to open the current data directory in your system file explorer (Windows Explorer, macOS Finder, etc.). This is a quick way to locate backup files or verify the folder contents.

Notes

Never delete kitted.db while the application is running. Kitted keeps the database file open. Copying or backing it up while the app is running should go through the built-in backup feature, which uses SQLite’s online backup API for a consistent snapshot.
The .jwt-secret file is sensitive. It controls login token validity. If it is deleted, all active sessions are immediately invalidated and users will need to log in again. Do not share it.
Moving files manually. If you change the data directory path in Settings, existing files are not moved automatically. Copy all contents from the old directory to the new one before restarting, or you will start with a fresh, empty database.