BoxTrack

Self-Hosted Inventory and Storage Management System

A self-hosted web application for tracking physical items across rooms, bins, and storage containers.

---

Features

• Zero Configuration — Just run and start organizing
• Hierarchical Organization — Zones → Containers → Items
• QR Code Generation — Print labels for quick mobile scanning
• Photo Attachments — Capture images directly from your device camera
• Color-Coded Zones — Visually organize different areas
• Print Manifests — Generate detailed inventory lists for each container
• Global Search — Find any item instantly across all locations
• Dark/Light Mode — Easy on the eyes, day or night
• Responsive Design — Works on desktop, tablet, and mobile

---

What does it look like?

Home Screen

Add An Item

Viewing A Zone

Viewing A Storage Container

The Print Manifest

Quick Start

Docker (Recommended)

docker run -d \
  --name boxtrack \
  -p 5001:5001 \
  -v boxtrack_data:/data \
  --restart unless-stopped \
  netpersona/boxtrack:latest

Open http://localhost:5001 in your browser.

Docker Compose

services:
  boxtrack:
    image: netpersona/boxtrack:latest
    container_name: boxtrack
    restart: unless-stopped
    ports:
      - "5001:5001"
    volumes:
      - boxtrack_data:/data

volumes:
  boxtrack_data:

docker compose up -d

---

Data Persistence

Your inventory data is stored in a SQLite database inside the /data directory. Mount this as a volume to preserve data across updates:

• Docker volume: -v boxtrack_data:/data
• Host path: -v /path/on/host:/data

---

Updating

docker pull netpersona/boxtrack:latest
docker rm -f boxtrack
docker run -d \
  --name boxtrack \
  -p 5001:5001 \
  -v boxtrack_data:/data \
  --restart unless-stopped \
  netpersona/boxtrack:latest

Your data remains safe in the mounted volume.

---

Unraid Installation

1. Go to Docker tab → Add Container
2. Set Repository: netpersona/boxtrack:latest
3. Add Port: Host 5001 → Container 5001
4. Add Path: Host /mnt/user/appdata/boxtrack → Container /data
5. Click Apply

---

Environment Variables

Variable	Default	Description
PORT	5001	Application port
BOXTRACK_DATA_DIR	/data	Database storage location
TZ	UTC	Timezone

---

Tech Stack

• Frontend: React, TailwindCSS, shadcn/ui
• Backend: Express.js, Node.js
• Database: SQLite with WAL mode
• Build: Vite, esbuild

---

Screenshots

Command Center

Overview dashboard with zone statistics and recent activity.

Container View

Detailed inventory list with photos, quantities, and values.

QR Labels

Print-ready labels with scannable codes for quick access.

---

Contributing

Contributions, issues, and feature requests are welcome!

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

License

MIT License - Use it, modify it, self-host it.

See LICENSE for more information.

---

Built for people who want to find their stuff.

Star us on GitHub — it helps!