Help and troubleshooting
Short answers to what people hit first. If yours is not here, write to us.
Troubleshooting
Section titled “Troubleshooting”| You see | What to try |
|---|---|
| “Can’t reach the server” | Check the address and that your phone can reach it (the same Wi-Fi for a home server). Plain http:// addresses on your own network are allowed. UniBox keeps showing saved data meanwhile. |
| “The server rejected those credentials” | The key or password is wrong, or was deleted on the server. Create a new API key or token and use Edit connection… on the source. |
| “Your sign-in has expired” | Open the source and choose Sign in again…, or tap Reconnect when scanning. Your labels and saved data stay attached. |
| “That doesn’t look like a supported server” | The address may be missing a port, or it is not a Homebox or InvenTree server. |
| The server is “older than the supported” version | Update Homebox to 0.26 or newer. |
| “Camera access is off” | Allow the camera for UniBox in your phone’s Settings, or type the label’s code by hand on the Scan tab. |
| “Unlinked inventory label” | This label is not linked on this phone yet. Tap Link this label and choose its container. |
| “Container no longer exists” | The box was deleted on your server. Rebind label to another container, or remove the binding. |
| “Source not connected” | The source this label pointed at was removed. Link to another container, or remove the label. |
| A box I just added in Homebox or InvenTree is missing | Pull down on Sources (or on the box list while binding) to read the server again. |
| An item does not show up in search offline | Only items stored in a container are saved on the phone. Items with no container appear when the server is reachable. |
| A container says “0 items” but has things in it | They may be in places inside it, which show as N items inside. Pull down on Sources to refresh counts. |
| Scanning a label with the phone’s Camera app opens a web page, not UniBox | UniBox must be installed on that phone. If it is, open the page and tap Open in UniBox. |
| “Already on …” while binding | That sticker is already bound. Scan another, or remove its binding first. |
See also: Connect a source, Offline and syncing.
Contact
Section titled “Contact”Still stuck? Write to hello@unibox.cam. Please include what you tried, what the app said, which system you connect to (Homebox or InvenTree, and its version) and your iPhone or Android model.
Please do not send API keys, passwords or screenshots that show them.