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.

Start with a small catalogue

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.

Sharing and permissions

Open Share & manage from a collection to manage who can use it. A Viewer can browse and search; an Editor can also manage items; a Collection Admin can manage members and the collection itself. Site admins manage accounts and can access every collection.

Only invite people who should have access to that collection. Review the role before saving an invitation.

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.

Need help with your setup?Contact support