₿ Bitcoin Portfolio — Usage & Setup

Download & Local Installation

All downloads are in the app's main repository.

Variant 1 — JAR (Java required)

Requirement: Java 21+ installed.

1. In the repository, go to Releases (right sidebar on GitHub) and download the latest btc-tracking.jar.
2. Open a terminal in the download folder.
3. Start the app:

   java -jar btc-tracking.jar

4. The browser opens automatically to http://localhost:8080/btc-tracking. Data is stored by default in btc-tracking-data.mv.db next to the JAR (H2, persistent) — back up this file to keep your data.

Variant 2 — Portable ZIP for Windows (no Java needed)

Includes a bundled JRE — no separate Java installation required.

1. In the repository, download the Windows ZIP under Releases (includes bundled JRE + launcher).
2. Fully extract the ZIP (don't just open it — the JRE needs to be extracted too).
3. In the extracted folder, run BtcTracking.exe (or the .bat startup script).
4. The server starts locally on port 8080, the browser opens automatically to http://localhost:8080/btc-tracking.

Installation on Umbrel

The app can also be installed as an app on an Umbrel node — via a dedicated Community App Store, no listing in the official Umbrel App Store required.

1. In the umbrelOS interface, go to the App Store and open the section for Community App Stores (that's where external store URLs can be added).
2. Enter the URL:

   https://github.com/thatsme4now/thatsme4now-umbrel-apps

3. Add the store — Umbrel loads the apps contained in the repository.
4. Select the app “BTC Tracking” from this community store and install it like any other Umbrel app.
5. After installation the app is reachable via the Umbrel dashboard, data stays persistent on the Umbrel node.

Installation via Docker

The app is also available as a Docker image — runs isolated, without a local Java installation.

Requirement: Docker installed (e.g. Docker Desktop on Windows).

1. Open a terminal or PowerShell.
2. Start the container:

   docker run -d \
     --name btc-tracking \
     -p 8080:8080 \
     -v btc-tracking-data:/app/data \
     thatsme4now/btc-tracking:latest

3. Open the app in your browser at http://localhost:8080/btc-tracking.

Installation via Proxmox

There's no dedicated Proxmox template — it runs via a regular VM or LXC container on the Proxmox node with Docker installed. From there, the same steps as Option C apply.

1. On the Proxmox node, create a VM or a (privileged or unprivileged) LXC, e.g. with Debian/Ubuntu.
2. Install Docker inside the VM/LXC.
3. Run the docker run command from Option C inside the VM/LXC.
4. Reach the app via the VM/LXC's IP: http://<VM-IP>:8080/btc-tracking.

Which variant fits?