InventoryWare

Overview

Inventory Ware is a self-hosted inventory management app for tracking belongings with image-based labeling. It lets you organize items with manual labels or optional AI image analysis.

Run Inventory Ware

Choose one of the two Docker-based options below. Both run the full app and save your data between restarts.

Option 1: Single Container (Simplest)

This option runs the web app and database in one container. It is the quickest way to get started.

docker run -d \
  --name inventory-ware \
  -p 8888:80 \
  -v data:/data \
  -e POCKETBASE_ADMIN_EMAIL=admin@example.com \
  -e POCKETBASE_ADMIN_PASSWORD=change-this-password \
  ghcr.io/make-ware/inventory-ware:latest

What this does:

• Starts the app in the background.
• Opens the web app on port 8888.
• Creates the admin account you provided.
• Stores all data in a Docker-managed volume named data.

Option 2: Docker Compose (Split Services)

This option runs the web app and database as separate containers. It is better if you want clearer separation or plan to scale later.

From the docker directory, start the services:

docker compose up -d

Important: with Docker Compose, create the first admin account manually in the PocketBase Admin UI.

To stop the services:

docker compose down

Accessing the Application

Monolithic Image

• Web Application: http://localhost:8888
• PocketBase Admin UI: http://localhost:8888/_/

Docker Compose

• Web Application: http://localhost:3000
• PocketBase Admin UI: http://localhost:8090/_/

Data Persistence

Both methods use Docker volumes to ensure your data is saved even if the containers are removed.

• Monolithic: Uses a volume named data.
• Docker Compose: Uses a volume named data (defined in docker-compose.yml).