Know what's in every box.
Brick Bin is a free, self-hosted web app for a household's building-brick sets: LEGO, Mould King, CaDA, COBI, BlueBrixx, Lumibricks and whatever arrives next.
It runs on your own server and remembers each box you own, where it lives, how built it is and which pieces have gone missing. It's for families and collectors who run a small home server, or are curious enough to start.
Built. Done, on display, and due for dusting.
Every copy you own is in one of these six states. Changing it takes one tap. Go on.
A set is the design.
A copy is a box you own.
Five copies of one polybag is normal here. Brick Bin keeps the five apart, each with its own build state, place, owner, price and value.
- Copy 1SealedHall closet
- Copy 2BuiltLiving-room shelf
- Copy 3DisassembledBlue tub
- Copy 4DisassembledBlue tub · 4 missing
- Copy 5MixedSomewhere in the big tub
What it keeps track of
Sets, the boxes you own of each, and everything that goes missing from them. All of this is in version 1 today.
Build state
Sealed, opened, in progress, built, disassembled or mixed. Each copy has a one-tap menu to move between them.
Missing pieces
Logged as real catalog parts: part, color and quantity, with pictures. Pick from the set's own inventory or search the whole catalog.
Shopping list
Everything missing, grouped by part and color. Use store-trip mode on your phone, or export to BrickLink wanted-list XML, Rebrickable CSV or plain CSV.
Catalog lookup
Search LEGO sets using Rebrickable data you import yourself. Nothing is fetched on a schedule. An admin presses the button.
Instructions
Upload PDFs, save a link, or save a PDF from a web address. On a phone you can jump around the file.
Collection and value
Totals, what you paid against estimated value, values that have gone stale, and what's still sealed.
Wishlists, with a secret
One list per person. Anyone can privately mark "I bought this", and only they ever see it. Not admins, not the activity log. "We got it" turns a wish into a set.
Kid profiles
Read-only, with no prices and no shopping list. Kids manage their own wishlist. Sets marked hidden look as if they don't exist, and the server enforces it.
Private by construction
Your data stays on your server. Nothing loads from a CDN, and the app makes no background downloads.
Also in the bin: CSV import from a Rebrickable set list, a Brickset export or any spreadsheet, an activity trail, a trash you can restore from, light and dark themes, and layouts made for phones first.
One page per set, one row per box
The set page shows the design once, with every copy you own listed beneath it. On a phone, the shopping list becomes a checklist you can work through in the store aisle.
- Screen
- Set detail page.
- State
- One polybag set with five copies: one sealed, one built, two disassembled (one of them missing 4 pieces) and one mixed.
- Viewport and theme
- Desktop, 1440 wide, light.
- Focus
- The copies list, each row with its own state and place. Crop to the set header and the list; leave out the page footer.
- Screen
- Shopping list in store-trip mode.
- State
- About twelve missing parts across three sets, grouped by part and color, three ticked.
- Viewport and theme
- Phone, 390 wide, dark.
- Focus
- The part pictures and the large checkboxes. Full screen, no browser chrome.
How self-hosting works
Four bricks, bottom to top
Brick Bin lives on a machine you own and answers on your own network. Most of the time goes on waiting for the catalog to download, which is a fine excuse to go build something.
Start the stack
On a Proxmox VM or LXC with Docker, one compose file starts the app and its own Postgres 17.
Reach it over Tailscale
A Tailscale sidecar serves HTTPS at
https://brick-bin.<your-tailnet>.ts.net, so the app answers only on your network.Create the household
The first visit asks you to name the household and create the admin account. Everyone else is added from there.
Import the catalog
An admin presses the button and Brick Bin loads the LEGO catalog from Rebrickable: about 6 GB of part images plus a data archive.
Updates look after themselves. Watchtower checks for a new app image every five minutes. Postgres is never auto-updated, because databases deserve a human in the room.
Only want a look? Run the production compose file without Tailscale and open port 3000. How hosting works
What you won't find here
- An account with usNone
You create the household and its admin on your own server. We never see either.
- A subscription$0
Brick Bin is free and open source. There is no paid tier further down the page.
- TrackingNone
This site has no analytics and no trackers. The app loads nothing from a CDN.
Not in version 1, either
- Loose-brick inventoryNot yet
- Owned minifiguresNot yet
- A build logNot yet
- LoansNot yet
- RatingsNot yet
- Guest share linksNot yet
- Price-guide integrationsNot yet
- Currencies other than USDNot yet
If one of those is the thing you need, better to hear it now than after the catalog download.
- FAQShort answers to fair questions→
- ConfigurationEvery setting, with its default→
- HostingWhat runs, what it stores, how to back it up→
- TutorialsTen walk-throughs, from first run to collection value→
Got a spare evening and a server?
The setup guide goes from an empty VM to your first set on the shelf. Bring a Tailscale key and several gigabytes of disk.
Start the setup guide