Skip to content

Sentry WMS

Sentry WMS is a free, open-source warehouse management system built for e-commerce fulfillment.

It connects barcode scans, pick tasks, and inventory movements to whatever database or ERP your business runs on. Sentry handles the physical warehouse execution layer -- receiving, storage, picking, packing, shipping, and counting -- so your system of record stays accurate.

Features

  • Receiving -- scan PO barcodes, verify items, stage for put-away
  • Put-Away -- suggested bin placement with preferred bin priorities, scan-to-confirm storage
  • Pick Walk -- multi-order batch picking with serpentine walk path optimization
  • Pack Verification -- scan-to-verify pack station with item-by-item confirmation
  • Shipping -- carrier and tracking entry, fulfillment recording
  • Cycle Counting -- bin-level counts with variance detection and admin approval workflow
  • Bin-to-Bin Transfer -- move inventory between locations with audit trail
  • Inter-Warehouse Transfer -- cross-warehouse inventory moves
  • Inventory Adjustments -- direct add/remove with reason tracking
  • Barcode Lookup -- scan any barcode from the home screen to identify items, bins, POs, or SOs
  • Connector Framework -- pluggable ERP / commerce sync with encrypted credential vault, sync-health dashboard, rate limiting, and circuit breaker
  • Admin Panel -- React web app for warehouse managers to monitor operations and configure the system

Stack

Layer Technology
Mobile App React Native (Expo)
API Python / Flask
Database PostgreSQL 16
Admin Panel React 18 / Vite
Infrastructure Docker Compose

Quick Start

git clone https://github.com/hightower-systems/sentry-wms.git
cd sentry-wms
cp .env.example .env
# Set every required secret inside .env (JWT_SECRET, SENTRY_ENCRYPTION_KEY,
# REDIS_PASSWORD). See the comments in .env.example for generation commands.
docker compose up -d

The admin password is printed in the docker logs on first run:

docker compose logs db | grep "Admin password"

For local development with Vite dev-server and hot reload, layer on the dev overlay:

docker compose -f docker-compose.yml -f docker-compose.dev.yml up

Documentation

  • API Reference -- every endpoint with request/response examples
  • Deployment -- Docker setup, production config, mobile app
  • Admin Panel -- page-by-page guide to the web admin
  • Test Lab -- setting up a test environment with hardware scanners
  • Contributing -- how to set up the dev environment and submit PRs

Current Version

v1.3.0 -- 570 tests passing, connector framework shipped, external security audit with 4 Critical + 12 High fixes landed. See CHANGELOG.md for details and SECURITY.md for the security advisory rotation steps.

Licensed under MIT. Built by Hightower Systems.