Cellarly

Cellarly

Docker app from coderoftime's Repository

Overview

Self-hosted wine cellar manager. Every bottle lives at an exact row and position in a rack you can spin around in 3D, on a server that is entirely yours. Cellarly is in beta: every release so far is a pre-release of 1.0.0. This template runs the beta tag, the newest release. Search a wine catalog or snap a photo of the label, track what you paid and what it is worth, rate what you drink and watch the drink-window countdown. Everyone in your household gets an account with a cellar of their own, in German or English. Sign in as the admin with the email and password you set below. Everyone else registers at /register, and you approve them on the Admin page; set Registration open to false to take no more. No mail server is needed. Everything is stored in one SQLite file in the data folder, backed up daily and before an upgrade changes it, and downloadable and restorable from the Admin page. Keep that folder on a disk or pool of this server, not on a network share (NFS or SMB), where SQLite does not work reliably. Google Gemini (optional API key) powers label recognition, enrichment and the price and critics lookup. Free software under the AGPL-3.0. Source code: https://gitlab.com/coderoftime/cellarly, and Settings links to the source of the version you run.

Media gallery

1 / 6

Related apps

Explore more like this

Explore all

Details

Repository
registry.gitlab.com/coderoftime/cellarly:beta
Last Updated2026-11-13
First Seen2026-11-05

Runtime arguments

Web UI
http://[IP]:[PORT:3000]/
Network
bridge
Shell
sh
Privileged
false
Extra Params
--user 99:100

Template configuration

WebUI PortPorttcp

Port the web interface is served on.

Target
3000
Default
3000
Value
3000
DataPathrw

The SQLite database and its automatic backups. This is the only state the app has. Keep it on a disk or pool of this server, not on a network share (NFS or SMB), where SQLite does not work reliably.

Target
/app/data
Default
/mnt/user/appdata/cellarly
Value
/mnt/user/appdata/cellarly
Session secretVariable

Signs and encrypts the session cookie. At least 32 random characters, e.g. from `openssl rand -base64 32`. With a shorter one, or none, Cellarly does not start, and the log says so. Keep it stable: changing it signs everyone out.

Target
NUXT_SESSION_PASSWORD
Admin passwordVariable

Password of the admin account, which the first start creates. At least 8 characters, and not choose-a-password, the example an earlier Cellarly README showed: otherwise there is no admin, registering stays closed, and the log says why. Changing it here later has no effect; change it in Cellarly under Change password in the account menu.

Target
NUXT_ADMIN_PASSWORD
Admin emailVariable

Email the admin signs in with, read when the first start creates the admin; changing it later has no effect, except that an admin an earlier Cellarly created with no address, because this field was empty, gets it on the next start. It has to be an address no account has yet: otherwise no admin is created, and the log says so. Empty means admin@localhost.

Target
NUXT_ADMIN_EMAIL
Default
admin@localhost
Value
admin@localhost
Registration openVariable

true or empty: anyone who can reach Cellarly can ask for an account at /register, and the admin approves it or not. false takes no more registrations: the sign-in page no longer links to /register, which says it is closed. Any other value closes it too.

Target
NUXT_REGISTRATION_OPEN
Default
true
Value
true
Secure cookieVariable

false lets a browser keep the sign-in over plain http://, as when you open Cellarly at http://your-server:3000 from another device. Anything else, empty included, keeps the cookie Secure, which a browser keeps only over HTTPS: over http:// the sign-in page then says the browser did not keep the sign-in. Set it to true once Cellarly is reached only over HTTPS.

Target
NUXT_SESSION_COOKIE_SECURE
Default
false
Value
false
Gemini API keyVariable

Optional. Google Gemini key for label photos, enrichment, catalog search beyond the wines already in Cellarly, and the price and critics lookup. Without it, search answers from the catalog alone, and the camera, Enhance with AI and the lookup are not offered. Enhance with AI and the lookup search with Google Search, which needs a paid key.

Target
NUXT_GEMINI_API_KEY
Session idle daysVariable

How many days a sign-in lasts without being used. Each use starts them again, so whoever uses Cellarly stays signed in. Fractions such as 0.5 work. Empty means 30.

Target
NUXT_SESSION_IDLE_DAYS
Default
30
Value
30
Daily backups keptVariable

How many daily backups of the database to keep in the backups folder. Empty means 14, 0 switches them off. Backups taken before an upgrade or a restore are never deleted.

Target
NUXT_BACKUP_KEEP
Default
14
Value
14
Trusted proxiesVariable

Your reverse proxy's own address, or several, comma-separated, so the sign-in limits count each visitor rather than the proxy. Put the proxy, such as Nginx Proxy Manager, and Cellarly on a custom Docker network where the proxy has a fixed IP, list that IP, and its IPv6 address too if the network has IPv6, and point the proxy at Cellarly by its container name and port 3000, not at this server's address. Never list a network's gateway (x.x.x.1, such as 172.17.0.1) or a range that includes it, such as 172.17.0.0/16: IPv6 visitors, and connections from the server itself or from a container to the server's address, reach Cellarly from the gateway, and whoever connects from a listed address can claim any address. See Behind a reverse proxy in Cellarly's README.

Target
NUXT_TRUSTED_PROXIES
SMTP hostVariable

Optional. Together with SMTP from and SMTP public URL it switches on password-reset mails; without them an admin issues a temporary password instead. The mail goes out encrypted, see SMTP secure.

Target
NUXT_SMTP_HOST
SMTP fromVariable

Sender address of the password-reset mail, e.g. cellar@example.com.

Target
NUXT_SMTP_FROM
SMTP public URLVariable

Address the reset link points to, e.g. https://cellarly.example.com

Target
NUXT_SMTP_PUBLIC_URL
SMTP portVariable

Empty means 587, or 465 when SMTP secure is true. Set it only for a relay on another port.

Target
NUXT_SMTP_PORT
SMTP secureVariable

true: TLS from the first byte, on port 465 unless SMTP port names another. false: the connection starts in plain text and switches to TLS with STARTTLS, which the relay has to offer, or it gets no mail unless SMTP allow plaintext is true. Empty: true on port 465, false on any other. Don't set true with port 587 or 25, which start in plain text.

Target
NUXT_SMTP_SECURE
SMTP allow plaintextVariable

Only for a relay with no TLS at all, on this server or a network you trust: true sends the reset mail, and the relay login if there is one, to it unencrypted. Empty or false: a relay that offers neither TLS nor STARTTLS gets no mail.

Target
NUXT_SMTP_ALLOW_PLAINTEXT
SMTP userVariable

Only for relays that ask for a login.

Target
NUXT_SMTP_USER
SMTP passwordVariable

Only for relays that ask for a login.

Target
NUXT_SMTP_PASSWORD