Vellaphine. Your private menopause and cycle diary.

# 1. Extract ZIP
unzip vellaphine.zip -d vellaphine
cd vellaphine

# 2. Build and start container
docker compose up -d --build

# 3. Open in browser
# http://<host>:8421

Default login: admin / admin — change it immediately under "Account" → "Password".

On first start, the following are created automatically: SQLite DB (data/vellaphine.db), session key (data/secret.key), and a VAPID key pair for web push.

sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo usermod -aG docker $USER

mkdir -p ~/docker/vellaphine && cd ~/docker/vellaphine
unzip /path/to/vellaphine.zip -d .
docker compose up -d --build

The first build compiles bcrypt/cryptography — approx. 2–3 minutes on x86_64.

sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl enable --now docker

mkdir -p ~/docker/vellaphine && cd ~/docker/vellaphine
unzip /path/to/vellaphine.zip -d .
docker compose up -d --build

Firewall: sudo firewall-cmd --permanent --add-port=8421/tcp && sudo firewall-cmd --reload

Install Docker Desktop (or OrbStack), then:

mkdir -p ~/Docker/vellaphine && cd ~/Docker/vellaphine
unzip ~/Downloads/vellaphine.zip -d .
docker compose up -d --build

Open the app in your browser: http://localhost:8421

wsl --install in PowerShell (Admin), then install Docker Desktop with WSL2 integration.

In the WSL2 shell (Ubuntu):

mkdir -p ~/docker/vellaphine && cd ~/docker/vellaphine
cp /mnt/c/Users/<Name>/Downloads/vellaphine.zip .
unzip vellaphine.zip
docker compose up -d --build

Container Manager (recommended): Install "Container Manager" from Package Center, extract the ZIP contents to /docker/vellaphine, then "Project" → "Create" using the existing docker-compose.yml.

Via SSH:

cd /volume1/docker && mkdir vellaphine && cd vellaphine
unzip /volume1/homes/admin/vellaphine.zip -d .
docker compose up -d --build

ssh user@nas-ip
sudo -i
mkdir -p /volume1/docker/vellaphine && cd /volume1/docker/vellaphine
unzip /volume1/uploads/vellaphine.zip -d .
docker compose up -d --build

UGOS default PUID/PGID (1000/10): if data/ is not writable, add user: "1000:10" in the compose file.

Install "Container Station" → "Applications" → "Create Compose" → paste the contents of docker-compose.yml, adjust the volume path to /share/Container/vellaphine/data:/data, and copy the ZIP contents to /share/Container/vellaphine/.

ssh root@truenas
cd /mnt/<pool>/docker && mkdir vellaphine && cd vellaphine
unzip /tmp/vellaphine.zip -d .
docker compose up -d --build

TrueNAS SCALE 24.10+ officially uses Docker; older versions may need a "Custom App" with the Dockerfile parameters.

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER && newgrp docker

mkdir -p ~/docker/vellaphine && cd ~/docker/vellaphine
unzip ~/vellaphine.zip
docker compose up -d --build

First build on Pi 4 takes about 6–8 minutes. 64-bit OS recommended.

curl -fsSL https://get.docker.com | sh
apt install -y unzip

mkdir -p /opt/vellaphine && cd /opt/vellaphine
unzip ~/vellaphine.zip
docker compose up -d --build

⚠️ On public servers: set up a reverse proxy with HTTPS (required for push notifications), close port 8421 in the firewall (only keep 80/443 open), and change the default password immediately.