Your wardrobe. Your data.
A free, open-source, self-hosted wardrobe organizer. Catalog your clothes, upload photos, build outfits, and access everything from your phone as an offline-ready PWA - all on your own server.
Crafted and engineered with care and intention by Lazztech LLC 🖤
v0.2.0 Released! - April 10, 2026
v0.2.0 - April 10, 2026:Clueless inspired outfit builder, Outfit Scheduling, Image Background Removal, & Customizable categoriesv0.1.9 - March 19, 2026:Garment list now orders by most recently addedv0.1.8 - March 13, 2026:Added French, German, and Spanish language support.v0.1.7 - March 7, 2026:Added Italian language support.v0.1.6 - March 6, 2026:Added garment search and filter.
For full details refer to the CHANGELOG.
docker run -d \
-p 3000:3000 \
-v librecloset_data:/app/data \
ghcr.io/lazztech/libre-closetOpen http://localhost:3000. No account required by default.
Want to try it without self-hosting? A public instance is running at https://librecloset.lazz.tech - register a free account to get started. No guest login exists, but registration is instant and requires no email verification.
Note, these screenshots are taken of the web application viewed as an installed standalone PWA. This tool may also be used like a traditional web app in the browser.
| Wardrobe (Mobile) | Outfits (Mobile) | Outfit Schedule (Mobile) | Outfit Builder (Mobile) |
|---|---|---|---|
 |
 |
 |
 |
| Wardrobe (Desktop) | Outfits (Desktop) | Outfit Schedule (Desktop) | Outfit Builder (Desktop) |
|---|---|---|---|
 |
 |
 |
 |
- Garment catalog - name, category, brand, size, colors, notes, photo
- Customizable categories - custom category support with filtering and input suggestion as you type
- Outfit builder - combine garments into saved looks with the Clueless inspired outfit builder
- Outfit Scheduling - schedule out multiple outfits for given days through the week and get a view of what you've worn
- Image Background Removal - Images automatically have their backgrounds removed and optimized WebP upon upload
- Offline-ready PWA - install to home screen, works without internet
- Optional auth - run open for personal use or enable JWT accounts for multi-user
- S3 or local storage - local disk by default, swap to any S3-compatible provider
- SQLite or PostgreSQL - SQLite by default, PostgreSQL for scale
- Multi-language - UI available in English, Italian, French, German, and Spanish
# SQLite + local storage (simplest)
docker run -d \
-p 3000:3000 \
-v librecloset_data:/app/data \
ghcr.io/lazztech/libre-closetservices:
libre-closet:
image: ghcr.io/lazztech/libre-closet
ports:
- '3000:3000'
volumes:
- librecloset_data:/app/data
environment:
AUTH_ENABLED: 'false'
PWA_ENABLED: 'true'
DATA_PATH: /app/data
restart: unless-stopped
volumes:
librecloset_data:git clone https://github.com/lazztech/libre-closet
cd libre-closet
cp .env .env.local # override defaults locally (gitignored)
npm install
npm run start:prod.env contains committed defaults. Override any value via a .env.local file (gitignored) or by passing real environment variables to Docker.
| Variable | Description | Default | Example |
|---|---|---|---|
APP_NAME |
Display name shown in the UI and navbar | Libre Closet |
My awesome Closet manager |
DATA_PATH |
Directory for SQLite DB and uploaded files | ./data |
./libre-closet-data |
AUTH_ENABLED |
Enable JWT user accounts and login | false |
true |
PWA_ENABLED |
Enable service worker and PWA install prompt | false |
true |
ACCESS_TOKEN_SECRET |
JWT signing secret - change for production | ChangeMe! |
u9n8c2y847rfctb23468tcb689f243 |
DATABASE_TYPE |
sqlite or postgres |
sqlite |
postgres |
DATABASE_HOST |
Postgres host | - | 192.168.10.5 |
DATABASE_PORT |
Postgres port | 5432 |
9867 |
DATABASE_USER |
Postgres user | - | postgres |
DATABASE_PASS |
Postgres password | - | 7yfhcn2349cr32f |
DATABASE_SCHEMA |
Postgres schema | postgres |
libre-closet-schema |
DATABASE_SSL |
Use SSL for Postgres | false |
true |
FILE_STORAGE_TYPE |
local or object (S3) |
local |
object |
OBJECT_STORAGE_ACCESS_KEY_ID |
S3 access key | - | AKIAIOSFODNN7EXAMPLE |
OBJECT_STORAGE_SECRET_ACCESS_KEY |
S3 secret key | - | wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY |
OBJECT_STORAGE_ENDPOINT |
S3-compatible endpoint URL | - | https://s3.example.com:8443 |
OBJECT_STORAGE_REGION |
S3 region | us-east-1 |
us-west-1 |
OBJECT_STORAGE_BUCKET_NAME |
S3 bucket name | libre-closet |
my-awesome-closet-manager-bucket |
EMAIL_FROM_ADDRESS |
From address for password reset emails | - | LibreCloset@example.com |
EMAIL_TRANSPORT |
gmail or mailgun |
gmail |
mailgun |
EMAIL_API_KEY |
Mailgun API key | - | fyhn2437cryb248cbrdc32 |
PUBLIC_VAPID_KEY |
Web push - generate for production | - | BEl62iUYgUivxIkv69yViEuiBIa-Ib9-SkvMeAtA3LFgDzkrxZJjSgSnfckjBJuBkr3qBUYIHBQFLXYp5Nksh8U |
PRIVATE_VAPID_KEY |
Web push - generate for production | - | UUxI4O8-FbRouAevSmBQ6o18hgE4nSG3qwvJTfKc-ls |
SERVER_BG_REMOVAL_ENABLED |
Enable server-side ONNX inference as fallback when client-side removal didn't run (e.g. older browser) or to lazily remove background from garments uploaded before background removal shipped. Disable on very low-powered hosts to prevent CPU spikes If false: nobg endpoint redirects to original, client-side script not loaded |
true |
false |
SERVER_BG_REMOVAL_CONCURRENCY |
Max concurrent server-side ONNX inference jobs (fallback path only) | 1 |
1 |
SERVER_BG_REMOVAL_MODEL |
ONNX model size for server-side background removal (small, medium, large) |
small |
medium |
Generate JWT secret:
openssl rand -base64 60Generate VAPID keys:
npx web-push generate-vapid-keys- Node (see
.nvmrc) - install via nvm - Docker (optional, for Postgres testing)
nvm install && nvm use
npm install
cp .env .env.local # override defaults locally (gitignored)
npm run start:devnpm run start:dev # watch mode
npm run start:prod # production
npm run test # unit tests
npm run test:e2e # Playwright end-to-end
npm run test:cov # coverage
npm run precommit # lint + test + lighthouse (run before committing)# SQLite (build first due to config differences)
npm run build
npx mikro-orm migration:create --config mikro-orm.sqlite.cli-config.ts
# PostgreSQL
npx mikro-orm migration:create --config mikro-orm.postgres.cli-config.ts# Build image
docker build --no-cache -f docker/Dockerfile . -t libre-closet:latest
# Cross-compile for linux/amd64 (e.g. building on Apple Silicon for a VPS)
docker buildx build --platform linux/amd64 --no-cache -f docker/Dockerfile . -t libre-closet:latestFor most self-hosters: deploy to a VPS via Coolify or Portainer using the docker-compose above with SQLite + local storage. SQLite handles thousands of users without issue - see DjangoCon 2023: Use SQLite in Production.
If you need horizontal scaling later, switch to S3-compatible storage and add Litestream for streaming SQLite backups before considering a PostgreSQL migration.
PRs and issues are welcome. This project is licensed under AGPL-3.0 - contributions must be compatible with that license.
