Set it up
Menu

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.

Build state of this copy

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.

Polybag racer5 copies
  • Copy 1SealedHall closet
  • Copy 2BuiltLiving-room shelf
  • Copy 3DisassembledBlue tub
  • Copy 4DisassembledBlue tub · 4 missing
  • Copy 5MixedSomewhere in the big tub
An illustration, drawn for this page. The real screen is below.

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.

LND-01Set detail pagedesktop · 16:10 · light
LND-01 · Set detail page
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.
LND-02Shopping list, store-trip modephone · 9:19.5 · dark
LND-02 · Shopping list, store-trip mode
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.

  1. Start the stack

    On a Proxmox VM or LXC with Docker, one compose file starts the app and its own Postgres 17.

  2. 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.

  3. Create the household

    The first visit asks you to name the household and create the admin account. Everyone else is added from there.

  4. 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.