Appearance
Quick Start
Get from login to your first catalogued item in about 5 minutes.
Prerequisites
- An ItemChaos instance running and reachable in your browser
- A user account (or the ability to register — the very first registration is automatically a superuser)
Step 1 — Log in (or register)
Go to /login. Enter your username and password.
If this is a brand-new installation, go to /register first. Fill in:
| Field | Notes |
|---|---|
| Owner Full Name | The display name for your inventory owner record |
| User Name | Your login username |
| Email Address | Optional but used for user management |
| Password / Confirm Password | Minimum requirements enforced by the form |
The first account created automatically receives superuser privileges.
Step 2 — Create a box
Navigate to Boxes in the top nav → click Create New Box.
Fill in at minimum the Box ID — a short, unique identifier for the physical box (e.g. GARAGE-01 or B0042). Name and description are optional.
Click Save. The new box appears in the Box Management grid.
Step 3 — Upload photos
Navigate to Uploads in the top nav.
Drag one or more item photos onto the upload area (or click to select files). Each file shows a preview, an MD5 hash, and a status badge.
- If a photo contains a QR code that matches a box ID, the box is detected automatically.
- Otherwise, use the BoxAutocomplete dropdown to assign photos to your new box.
Click Upload All. The backend creates an Item for each photo and associates it with the selected box.
Step 4 — Name your items
Go to Boxes. Your new box will show a Processed percentage of 0% because items have no names yet.
Click Name Unnamed Items on the box row. This takes you to /label-item/:boxId/, a focused view that lists every unnamed item in the box. Click an item's name field inline to type the name, or click the edit icon to open the full item editor.
When all items have names the box shows 100% processed.
Step 5 — Explore
| What you want to do | Where to go |
|---|---|
| See all items across all boxes | Items |
| Edit costs, dimensions, serial numbers | Items → click item → Edit Item |
| Print QR box labels | Labels |
| Identify something with AI | AI Identify |
| Transfer items to a new owner or box | Transfers |
| Manage users (superuser only) | Admin |