Questions, answered briefly
The short answer comes first. The reasons follow, for anyone who wants them.
Is this a LEGO app?
No. Brick Bin works with any brand of building brick, including Mould King, CaDA, COBI, BlueBrixx and Lumibricks. It isn't affiliated with the LEGO Group.
The catalog lookup covers LEGO sets, because that's what Rebrickable's data describes. Sets from other brands are added by hand, or from a spreadsheet.
Does it need the internet?
Not day to day. Your data stays on your server, nothing loads from a CDN, and the app makes no background downloads.
It goes online only when someone asks it to: an admin importing the catalog, a cover being fetched for a set you add from the catalog, a barcode you scan, or a PDF you ask it to save from a web address. Separately, the recommended install's Watchtower checks for a new app image every five minutes. The full list.
Where does the catalog come from?
Rebrickable. You import their data yourself, onto your own server.
Nothing is fetched on a schedule. An admin presses the button, and can do so at most once every 48 hours. The import tutorial walks through it.
Why do I have to wait 48 hours between imports from Rebrickable?
To stay well inside Rebrickable's rules. Their downloads page says: “You may automate downloading these archives at most once a day.” That is a little vague, so Brick Bin takes the cautious reading and waits 48 hours between imports.
In practice you'll rarely meet the limit. The import needs running a handful of times a year, once a month at most.
The same notice goes on: “Scraping our web pages is strictly against our Terms and will get you banned.” That is why Brick Bin doesn't read the downloads page itself, and an admin pastes its source in.
Can my kids see prices?
No. Kid profiles are read-only, with no prices and no shopping list. They can still manage their own wishlist.
Sets you mark as hidden look, to a kid profile, as if they don't exist. That rule lives on the server and is covered by tests, so it doesn't depend on a button being tucked out of sight. Birthday presents are safe.
Can I run it without Tailscale?
Yes. Run the production compose file and open port 3000.
Tailscale is what we recommend because it gives you HTTPS and a tidy address with very little work. Running without it is covered in the hosting docs.
How do I back it up?
Three things: database dumps, cover images and instruction PDFs.
The downloaded catalog images aren't backed up, and the dumps skip the catalog tables, because both can be imported again. After a restore, run a catalog import. Backups in detail.
Can I track loose bricks?
Not yet. Version 1 tracks sets and the copies you own of them, plus the pieces each copy is missing.
Also not in version 1: owned minifigures, a build log, loans, ratings, guest share links, price-guide integrations, and currencies other than USD.
What does it cost?
Nothing. Brick Bin is free and open source, under the MIT license. There's no account with us and no subscription.
You do supply the server, the disk and the bricks.