NIVORRA DOCUMENTATION
Self-hosted catalogue guide
Nivorra is a self-hosted catalogue for books, games, consoles, and other collections. Organise records into collections, track individual copies, add photos and notes, and connect related items.
Create a collection, add a few records, and check that the details and photos look right before inviting other people.
What you can do
- Make separate collections for books, games and consoles, music, films, or other things.
- Track what you own and what you are still looking for.
- Record multiple editions or copies, each with its own condition, price, and notes.
- Add tags, photos, and collection-specific details.
- Link related records so you can move between connected items.
- Share a collection with viewers, editors, or collection admins.
Server setup
Run Nivorra on a server you control, then open its web address in a browser. For a local installation, the default address is http://localhost:8787. The first account created during initial setup becomes the site admin.
Keep the persistent data storage attached to the service when you recreate or update the container. The exact image name, port mapping, and storage path depend on the Nivorra container distribution you deploy.
Docker Compose
The Compose example below is a scaffold. Replace the image, port, and persistent storage values with the published Nivorra container details before deploying it.
services:
nivorra:
image: <NIVORRA_IMAGE>
ports:
- "<HOST_PORT>:<CONTAINER_PORT>"
volumes:
- nivorra-data:<CONTAINER_DATA_PATH>
restart: unless-stopped
volumes:
nivorra-data:Start the service from the directory containing your Compose file with docker compose up -d. Use docker compose logs -f nivorra to follow its startup output.
For access from outside your home or office network, publish Nivorra through a reverse proxy with HTTPS. Keep the database and photo storage private; expose only the web service.
Create a collection
Use Create collection to give a group of records a name, type, and short description. Nivorra offers Books, Games & consoles, Music, Films, and Other. A collection keeps its records, tags, and sharing permissions together.
For a game library, a collection description can explain the platforms or era covered. For a reading list, describe the shelf or series you are cataloguing.
Add items and copies
Choose Add item, enter a title, and fill in useful details such as author or creator, platform, series, sequence number, tags, and notes. Mark a record as owned or incomplete to distinguish items you have from ones you still want.
Use Extra details for information specific to a record, such as ISBN, region, publisher, or a reference URL. Add a copy to record its edition, condition, price, acquisition date, photos, and condition notes. A single catalogue item can keep multiple copies together for comparison.
Link related items
In an Extra details value, type @ and part of another item’s title. Choose the matching suggestion to create an in-app link. Nivorra then shows the related item in the record’s Linked items section, including the field name used for the connection.
For example, a game record can link to another title in the same series, a console can link to its games, or a book can link to another volume. Links work across collections and appear from either side of the relationship.
Optional tools
When configured by the server admin, AI-assisted details can suggest item information for you to review before saving. An optional eBay asking-price guide can show a median of comparable current UK listings. Treat asking prices as a guide, not as confirmed sale prices or an appraisal.
Backups and updates
Before updating, moving, or replacing a server, make a backup and verify it is stored somewhere separate from the server. Preserve the persistent database and photo storage used by the container. The admin tools also offer a downloadable backup and a restore workflow.
After an update, confirm you can sign in, open your collections, and view item photos before removing the previous backup.

