DVinyl

DVinyl

Docker app from Kyonew's Repository

A self-hosted, plugin based collection manager for your Vinyls, CDs, Books, Movies, Games and LEGO sets.

Requirements

Nothing else: DVinyl keeps its whole collection in one SQLite file, in the Data volume. Upgrading from 3.x, which used MongoDB: nothing to change, DVinyl keeps running on it until the Data volume is set. Then the next start copies everything into SQLite (MongoDB is only read), after which you can clear the MongoDB URL setting and remove the MongoDB container. Guide: https://github.com/Kyonew/DVinyl/blob/main/docs/docker.md#-moving-to-sqlite
Overview
A self-hosted, plugin based collection manager for your Vinyls, CDs, Books, Movies, Games and LEGO sets.

DVinyl: your whole collection, on one beautiful shelf

DVinyl is a self-hosted manager for physical collections: records, books, films, games, LEGO, board games, trading cards, and any kind of item you define yourself.

Live Demo Documentation Wiki

License: MIT Version Self-Hosted Docker ZimaOS


Hey there 👋

DVinyl is a little home for your physical collection. It lives on your own server, pulls in cover art and metadata from the big databases (Discogs, Hardcover, Open Library, TMDB, IGDB, ScreenScraper, Rebrickable, BoardGameGeek), can even estimate what your records are worth, and lays it all out on virtual shelves that look like the real ones, in a style you get to shape yourself. Everything lives in one SQLite file: no database server to run.

DVinyl is plugin based: every media type is a plugin, so you turn on only what you care about, and you can add your own type without touching the core.

Want to see it before installing anything? Have a look at the live demo, a read-only preview of a finished instance.

What it can do

📦 Your whole shelf, in one place

  • Many formats. Music (vinyls, CDs, cassettes), books (manga, comics, hardcover), movies (Blu-ray, 4K, DVD, VHS, LaserDisc), video games and consoles, LEGO sets, board games and trading card games.
  • Your own types. Collect something else? Create a new type right from the app with the no-code plugin editor, or write a code plugin with its own API.
  • Collector details. Record size, speed, pressing plant, mastering and runouts per side from Discogs, film casts and original titles, several formats in one edition, boxsets holding their contents, and what you paid for each copy.
  • Multiple views & virtual shelves. Browse in a grid, a compact table, or as realistic virtual shelves with spine view and customizable furniture.
  • Lists & playlists. Curate custom lists within a collection and assemble tracks into playlists.
  • Multiple collections. Keep separate libraries (yours, the family's, by room) and switch in one click.
  • Smart import & barcode scanner. Add items by ID, scan physical barcodes with your camera, or bulk import existing libraries (Discogs with your own custom fields, Goodreads, any CSV).
  • Fast editing. Edit one field on a whole selection, save and go on to the next item, saved filter views, and table columns per type.
  • AI assist. Bring-your-own-key support for text, photo or barcode-fallback import, and for drafting a new no-code plugin from a one-sentence description. See the AI Assist guide to set it up.
  • Market value & price history. Live valuation estimates for your records and cards, with historical charts over time.
  • Game completion times. Playtime estimates powered by IGDB.
  • Printable labels. Generate printable QR codes and barcodes for your physical media.
  • Wishlist. Keep track of items you are hunting for.

🎨 Make it yours

  • A look per collection. A studio with a live preview: ready-made styles, a top bar, sidebar or dock, your own colour palettes, fonts, card shapes, logo and background.
  • Home page widgets. Arrange stats, latest additions, wishlist, lists and notes in a grid.
  • Collection info page. Add a rich Markdown presentation page with photos for your collections.
  • In your pocket. Installs on your phone like an app, with the barcode scanner one tap away.
  • Multilingual. English, French, German, Spanish, Italian and Russian.

👥 Share it, your way

  • Users and roles. Invite people to a collection as admin, editor or viewer, so everyone gets the right level of access, or send them a single-use invite link.
  • Requests & notifications. Members ask each other to borrow an item or offer a gift, under types the admin makes up, with push notifications on their phone.
  • See each other's wishes. Search results show who among your collections' members wishes for a record.
  • SSO login (OIDC). Optional single sign-on with providers like Authentik, Keycloak, Authelia or pocketID, with optional automatic account creation from an identity provider group.
  • Public share links. Generate a read-only link or QR code so anyone can browse a collection (or just part of it, e.g. only Vinyls) without an account.

💾 Your data stays yours

  • One file. The whole collection in one SQLite file, easy to back up.
  • Backups. Collection or whole-instance exports (ZIP with images, JSON, CSV), and automatic daily or weekly backups to a folder of your choice.
  • Local image copies. Optionally download the covers that are only links, so they never vanish and travel in your backups.

Supported media

Type Formats Metadata source API key
Music Vinyl, CD, cassette Discogs ✅
Books Books, manga, comics Hardcover, Open Library optional
Movies Blu-ray, 4K, DVD, VHS, LaserDisc TMDB ✅
Video games Games, consoles IGDB, ScreenScraper ✅
LEGO Sets Rebrickable ✅
Board games Games, expansions BoardGameGeek ✅
Trading cards Pokémon, Magic, Yu-Gi-Oh!, One Piece, Lorcana, Star Wars: Unlimited, Digimon, Flesh and Blood TCGdex, Scryfall, YGOPRODeck and others none

Each type can be turned on or off per collection. Add only the keys for the types you use: a type whose key is missing stays disabled. See API keys for where to get each one.

Build your own type

DVinyl is made to grow with you. There are two ways to add a new kind of collection:

  • Plugin editor (no code). Create a manual collection type right from the app, with your own fields, formats, icon and colors. No restart, no coding required. Short on ideas? The AI assist can draft one from a one-sentence description. See the Plugin editor guide on the Wiki.
  • Code plugin (with API). Drop a plugins/<id>/ folder that exports a plugin definition to add a full media type with its own external API, importers and stats. See the Plugin development guide.

Built one you are proud of? Do not hesitate to open a PR, I would genuinely love to see it! 🙌

Installation

Docker Compose (recommended)

services:
  dvinyl-app:
    image: ghcr.io/kyonew/dvinyl:latest
    container_name: dvinyl_app
    restart: unless-stopped
    ports:
      - "3099:3099"
    volumes:
      - ./data:/app/data # the SQLite database
      - ./public/uploads:/app/public/uploads # uploaded images
    env_file:
      - .env

Create a .env next to it from .env.example. Two secrets are required:

PASSJWT= # openssl rand -hex 32
SESSION_SECRET= # openssl rand -hex 32, a different one

Then start it and open http://your-server:3099 to create the first account:

docker compose up -d

More options (building from source, environment-only setup) are in the Docker guide.

Other platforms

Platform How
Unraid Community Applications, or the XML template (guide)
ZimaOS / CasaOS Add the source https://raw.githubusercontent.com/NoNoBzH22/TwoBytes-Store/gh-pages to the App Store, then install DVinyl (guide)
Proxmox LXC A small Debian container, no Docker (guide)
Node.js Run it directly on any machine (guide)

Configuration

All settings live in .env; .env.example documents every variable. The most common ones:

Variable Purpose
PASSJWT, SESSION_SECRET Required secrets, two different random values
SETUP_TOKEN Protects the first-run setup page while the instance is reachable by others
PROD Set to true only when served over HTTPS
VINYL_PORT, BASE_URL Port, and sub-path when served under one
PUBLIC_URL, PUSH_CONTACT Public address, used for links and push notifications
BACKUP_DIR Forces the folder for scheduled backups
DISCOGS_TOKEN, TMDB_API_KEY, TWITCH_CLIENT_ID… Metadata providers (API keys)
OIDC_* Single sign-on (details)
AI_* Optional AI import (AI Assist)

Behind a reverse proxy? See the HTTPS section.

Updating

docker compose pull && docker compose up -d

Back up your data/ folder first, or use the built-in backups. Coming from 3.x (MongoDB), your data is moved to SQLite automatically on first start: read Moving to SQLite before upgrading. Rolling back is covered in the Docker guide.

Documentation

Guide Content
Getting started Installation options, environment variables, reverse proxy
Docker deployment Compose setup, updates, persistence, backups
API keys Discogs, Hardcover, TMDB, IGDB, ScreenScraper, Rebrickable, BoardGameGeek
AI Assist Bring-your-own-key AI import and plugin drafting
Plugin development Build a media type as a code plugin
Public share links Read-only links to a collection
Wiki User guides and no-code tutorials

Tech stack: Node.js, Express, SQLite, EJS, Tailwind CSS, i18next.

Contributors

DVinyl is better for the people who jumped in. Huge thanks to everyone whose pull requests made it into main 💜 (hover an avatar to see their merged PRs)

Siebe-Uy teaboyteaboy ArtwoXYZ minchetas Sbax Kianuss HolyFab reneald RobertClarke64 mistic100 tonymarsh guillaumegay13

Want to see your name here? Bug reports, ideas, translations and plugins are all welcome. Please read CONTRIBUTING.md and the Code of Conduct first.

License

MIT

[!NOTE] Parts of the frontend and comments were generated with the help of AI tools. I reviewed and corrected the output where needed, but this project is not 100% human-made. Feedback is very welcome, including on the backend, where I may have made mistakes. Thank you for your understanding <3

Categories

Download Statistics

10,610
Total Downloads

Related apps

Links

Details

Repository
kyonew/dvinyl:latest
Last Updated2026-10-04
First Seen2026-05-24

Runtime arguments

Web UI
http://[IP]:[PORT:3099]
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp

The port DVinyl will be accessible on.

Target
3099
Default
3099
Value
3099
Data VolumePathrw

Where DVinyl keeps your collection: one SQLite file. Required on a new install: the container refuses to start while it is not set. Back this folder up.

Target
/app/data
Default
/mnt/user/appdata/dvinyl/data
Value
/mnt/user/appdata/dvinyl/data
Backups FolderVariable

Optional. Fixes the folder of automatic backups, a path inside the container, and locks that field on the Instance admin page (Backup tab). Leave empty to choose it on that page.

Target
BACKUP_DIR
Uploads VolumePathrw

Directory to store uploaded files like covers.

Target
/app/public/uploads
Default
/mnt/user/appdata/dvinyl/uploads
Value
/mnt/user/appdata/dvinyl/uploads
MongoDB URL (upgrade from 3.x only)Variable

Only to upgrade from DVinyl 3.x: the MongoDB your data is on, for example mongodb://[IP_OF_MONGODB]:27017/dvinyl. DVinyl keeps running on it until the Data volume is set; the next start then copies everything into SQLite, after which this is no longer read and can be cleared. Leave empty on a new install.

Target
MONGODB_URL
JWT PasswordVariable

Secret used to sign session tokens. Required: DVinyl refuses to start while this is empty or left at a published placeholder. Generate one with: openssl rand -hex 32

Target
PASSJWT
Session SecretVariable

Secret used to encrypt sessions. Must differ from the JWT password. Required: DVinyl refuses to start while this is empty or left at a published placeholder. Generate one with: openssl rand -hex 32

Target
SESSION_SECRET
Setup TokenVariable

Optional. Asked on the first-run setup page, to create the admin account or restore a backup, so nobody else can claim a fresh instance before you. Generate one with: openssl rand -hex 16

Target
SETUP_TOKEN
HTTPS Production ModeVariable

Change to true ONLY if you use HTTPS via a reverse proxy.

Target
PROD
Default
false
Value
false
Vinyl Port VariableVariable

Internal port variable required by the app.

Target
VINYL_PORT
Default
3099
Value
3099
Base URLVariable

Base URL for serving on a sub-path, leave empty to serve from root.

Target
BASE_URL
Discogs API TokenVariable

Your Discogs API Token for Vinyls/CDs.

Target
DISCOGS_TOKEN
Hardcover API KeyVariable

Your Hardcover API Key for Books.

Target
HARDCOVER_API_KEY
TMDB API KeyVariable

Your TMDB API Key for DVDs.

Target
TMDB_API_KEY
Twitch Client IDVariable

Your Twitch Client ID for Games.

Target
TWITCH_CLIENT_ID
Twitch Client SecretVariable

Your Twitch Client Secret for Games.

Target
TWITCH_CLIENT_SECRET
Rebrickable API KeyVariable

Your Rebrickable API Key for LEGO sets.

Target
REBRICKABLE_API_KEY
OIDC Issuer URLVariable

Optional single sign-on. Your OIDC provider issuer URL (Authentik, Keycloak, Authelia, pocketID...). Leave empty to disable SSO.

Target
OIDC_ISSUER_URL
OIDC Client IDVariable

Optional single sign-on. The client ID registered on your OIDC provider.

Target
OIDC_CLIENT_ID
OIDC Client SecretVariable

Optional single sign-on. The client secret registered on your OIDC provider.

Target
OIDC_CLIENT_SECRET
OIDC Redirect URIVariable

Optional single sign-on. Must exactly match the callback registered on your provider, always ending with /login/oidc/callback.

Target
OIDC_REDIRECT_URI
OIDC Button LabelVariable

Optional single sign-on. Text shown on the SSO login button, for example 'Sign in with Authentik'.

Target
OIDC_BUTTON_LABEL