# WhiskyWise

WhiskyWise is a self-hosted web app for tracking your whisky collection, logging tasting notes, and analysing flavour profiles. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/3476/whiskywise

## Description

WhiskyWise is a self-hosted web app for tracking your whisky collection, logging tasting notes, and analysing flavour profiles. It provides a clean, distraction-free interface with a tasting journal covering Nose, Palate, and Finish, a 10-point rating system with badge display, interactive flavour radar charts with 16 presets, photo storage for up to four angles per bottle, and purchase tracking with configurable currency. Built for spirits enthusiasts who want a focused, no-frills way to manage their journey through the world of whisky. A native Android companion app connects directly to your instance via the built-in REST API (requires server v1.5.4 or later).

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 3 of 4 factors.
- Maintained: 58 (last commit 169 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/heisenbugger86/whiskywise
- Unraid: https://ca.unraid.net/apps/whiskywise-0h2ha9t0ucvgel?q=WhiskyWise

## Common questions

### How can I back up WhiskyWise?

Use Backup & Restore in the Admin Panel to create a ZIP containing the database and all photos.

### What should I know about SECRET_KEY when running Docker?

Set a persistent SECRET_KEY in the container variables. If it is empty or the default, a random key is generated at startup and sessions will not survive a container restart.

### How do I install WhiskyWise on Home Assistant?

Add the WhiskyWise repository, install the add-on, set the secret_key in Configuration, then start it. Data is kept in the add-on's persistent /data volume.

### What port does the Docker install use?

The Docker Compose instructions start the app and point your browser to localhost:5000.

### Does the Android app work with self-hosted WhiskyWise?

Yes, the native Android companion app connects directly to your instance through the REST API. It requires server version 1.5.9 or later.

---
Source: Our Local Host (https://ourlocalhost.com/app/3476/whiskywise), the self-hosted and open-source app directory.
