# Koillection

> Catalogue your books, records, games or any collection, your way.

- Page: https://cgt.octabyte.io/templates/koillection/
- Category: Inventory & assets
- Replaces: CLZ (Collectorz)
- Ease of use: Easy. Open the app's address and create the admin account, then make your first collection.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: Collectors of records, books, games, cards or figures who want a private, custom catalogue
- Official website: https://koillection.github.io
- Documentation: https://github.com/koillection/koillection/wiki
- Source code: https://github.com/koillection/koillection
- Last updated: 2026-11-20

## What is Koillection?

Koillection is a self-hosted collection manager for books, records, games and more, with photos, custom fields, wishlists and loans.

Koillection is a self-hosted collection manager for keeping track of physical collections of any kind, a free alternative to CLZ's collector apps. Books, records, DVDs, stamps, board games, trading cards or figures: you make a collection, add items with photos, and record the details that matter to you.

Each item can carry your own fields, such as artist, year, condition or the shelf it sits on, and templates let you reuse a set of fields. Tags work across collections, a wishlist keeps track of what you're still hunting for, and loans show who borrowed what. A record collector, for example, could catalogue every album with its pressing year and condition, keep a wishlist for record fairs, and share a public page of the collection with friends.

Koillection doesn't download details on its own. You type them in, or set up a scraper that copies them from a web page such as Discogs. It runs in any browser, including on phones, and several people can have their own accounts.

Cloudgate installs Koillection on your server with its database and gives it a secure web address. The first person to open it creates the admin account.

## What you can do with Koillection

- **Catalogue any kind of collection**: Make collections and sub-collections for books, records, stamps, games, figures or anything else, each item with its own photos.
- **Record the details you care about**: Add your own fields, such as artist, year, condition or shelf, and save them as templates to reuse.
- **Keep a wishlist**: List the items you're still looking for, with pictures and notes.
- **Know who borrowed what**: Track loans, so you remember which friend has your book or game.
- **Tag and search**: Tag items across collections and find anything with search and saved searches.
- **Show it off, or keep it private**: Make each collection or item public, visible only to signed-in users, or private.
- **Fill details from a web page**: Set up your own scraper to copy an item's name, picture and details from a site like Discogs.

## Replaces CLZ (Collectorz)

Koillection does the same job as CLZ (Collectorz). Here is what changes when you switch.

### What you gain

- One free app for every kind of collection, instead of one app per type
- Your own fields, so the catalogue fits what you collect
- No subscription, and your catalogue stays on your own server
- Public pages to share a collection with friends

### What is different

- No barcode scanning or automatic details; you type them in or set up a scraper
- There is no phone app, only the website, which can be added to the home screen
- No import from CLZ, so you start your catalogue fresh
- It's for collections, not for business stock or storage locations

## What happens when you click Deploy?

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

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Koillection 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 Koillection.** 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 Koillection free?

Yes. Koillection is free, open-source software under the MIT licence, with no paid edition. You pay only for your server.

### Is Koillection a good alternative to CLZ?

Yes, if you want one free catalogue for every kind of collection, with fields you choose. CLZ apps scan barcodes and fill in details automatically; Koillection doesn't, and it can't import a CLZ database, so you add items yourself or with a scraper you set up.

### Does Koillection fill in item details automatically?

No, not out of the box. In Koillection you can build your own scraper that copies an item's name, picture and details from a web page such as a Discogs release, but the feature is still experimental.

### How do I sign in to Koillection the first time?

Open Koillection's web address and you'll see a setup page that creates the first account. That account is the admin, so do this right after setup.

### Can I share my Koillection collection with friends?

Yes. Each Koillection collection and item can be public for anyone, internal for signed-in users only, or private, and a setting for your whole account limits what is shown.

### Is there a Koillection app for my phone?

No, there is no app in the stores. Koillection works in the phone's browser and can be added to the home screen.

### Do I need technical skills to run Koillection?

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

### Do I need my own server for Koillection?

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

### Can I move my data from CLZ (Collectorz) to Koillection?

Most people export from CLZ (Collectorz) and import into Koillection. The official guides at github.com walk through it.
