# Part-DB

> Track electronic parts, where they are stored and what they cost.

- Page: https://cgt.octabyte.io/templates/part-db/
- Category: Operations
- Replaces: PartsBox and Sortly
- Ease of use: Easy. The first start takes about a minute; then sign in as admin with the password Cloudgate shows you and change it.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: AGPL-3.0-or-later
- Good for: Electronics workshops, repair shops, makerspaces and labs that keep a stock of components
- Official website: https://github.com/Part-DB/Part-DB-server
- Documentation: https://docs.part-db.de/
- Source code: https://github.com/Part-DB/Part-DB-server
- Last updated: 2026-11-20

## What is Part-DB?

Part-DB is a self-hosted electronic parts inventory: track components, stock, storage locations, prices and datasheets, with labels and KiCad.

Part-DB is free, open-source electronic parts inventory software you can self-host, used in place of PartsBox to track which components you have, where each one is stored, what it costs and which datasheet goes with it. Everyone works in the browser, on a computer, tablet or phone.

Each part gets a category, footprint, manufacturer, storage location, stock count, prices and files. Part-DB can fill in details, datasheets and prices from distributors such as Digi-Key, Mouser and LCSC, and find parts by their specifications. Projects hold a bill of materials, show how many boards you can build from stock and take the parts out in one step. A repair shop, for example, could label every drawer, scan a drawer to see what is in it, and check before quoting a job whether it has the capacitors it needs.

Part-DB imports parts from CSV and Excel files, moves an existing PartKeepr database across, prints barcode labels and connects to KiCad. Users and groups get their own permissions, and a history shows who changed what.

Cloudgate installs Part-DB on a server Cloudgate provides or one you connect and gives it a secure web address. The first start takes about a minute; then sign in as admin with the password Cloudgate shows you.

## What you can do with Part-DB

- **Keep a catalogue of parts**: Give each part a category, footprint, manufacturer, tags, price and its datasheets and photos.
- **Know where every part is**: Record which drawer, box or shelf holds each part and how many are left, with a minimum stock level.
- **Fill in parts from your suppliers**: Pull part details, datasheets and prices from distributors such as Digi-Key, Mouser, LCSC and Farnell with your own account keys.
- **Find parts by their specifications**: Search and filter by values such as voltage or package, not only by name.
- **Plan builds with bills of materials**: Add a project's parts list, see how many you can build from stock and take all its parts out in one step.
- **Print labels and scan barcodes**: Print barcode labels for parts and storage locations and scan them with a webcam or phone camera.
- **Share the stock safely**: Give people and groups their own permissions and two-step sign-in, and see who changed what, with the option to undo it.
- **Use it from KiCad**: Connect KiCad 8 or newer so designers pick parts you actually have in stock.

## Replaces PartsBox and Sortly

Part-DB does the same job as PartsBox and Sortly. Here is what changes when you switch.

### What you gain

- No subscription and no fee for each extra user
- Your parts list, prices and supplier data stay on your own server
- Every feature is free, including projects, labels and supplier lookups
- Open source under the AGPL, with no paid edition

### What is different

- It is a parts inventory, with no purchase orders or sales
- There is no PartsBox importer; you bring your parts over as a CSV or Excel file
- Prices are kept in euros as the base currency, which cannot be changed later, though parts can also carry prices in other currencies
- Supplier lookups need an account and key from each distributor

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=part-db

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Part-DB itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Part-DB.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Part-DB free?

Yes, Part-DB is free and open source under the AGPL-3.0 licence, with no paid edition and no limit on parts or users. You pay only for your server.

### Is Part-DB a good alternative to PartsBox?

Yes, for a workshop that wants its electronic parts inventory on its own server. When we checked in November 2026, PartsBox was free for one user and its team plans started at €49 a month, with €12 a month for each extra user. Part-DB has no fees and covers stock, storage locations, prices, datasheets, bills of materials, labels and KiCad, while PartsBox is more polished and adds ordering and production tools on its higher plans.

### How do I sign in to Part-DB the first time?

Sign in to Part-DB with the user name admin and the password Cloudgate generates, shown on the app's variables page. There is no public sign-up; the admin creates accounts for everyone else.

### Can I move my parts to Part-DB from PartKeepr, PartsBox or a spreadsheet?

Yes from PartKeepr, partly from the others. Part-DB has a PartKeepr migration tool, still marked beta, that brings over parts, categories, footprints, storage locations, prices, attachments and projects. From PartsBox or a spreadsheet you export a CSV or Excel file and import it; there is no direct PartsBox importer.

### Should I use Part-DB or InvenTree?

Choose Part-DB if you mostly keep electronic components, and InvenTree if you also buy, sell and build products. Part-DB is built for electronic components, with footprints, datasheets, search by specifications and supplier lookups. InvenTree covers any kind of stock and adds purchase orders, sales orders and build orders.

### Does Part-DB work with KiCad?

Yes, Part-DB can act as a parts library for KiCad 8 or newer, so designers see the parts you keep in stock inside KiCad. Part-DB can also import a KiCad bill of materials into a project.

### Is there a Part-DB phone app?

No, Part-DB has no phone app, but its website works on phones and tablets, and its built-in scanner reads barcode labels with the phone's camera.

### Do I need technical skills to run Part-DB?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Part-DB and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Part-DB?

No. When you deploy Part-DB, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
