BTC-Tracking App — Nutzung & Setup

OPTION A

Download & lokale Installation

Alle Downloads liegen im Haupt-Repository der App.

github.com/thatsme4now/btc-tracking Quellcode, Releases, README mit allen Setup-Varianten

Repository öffnen ↗

Variante 1 — JAR (Java erforderlich)

Voraussetzung: Java 21+ installiert.

Im Repository auf Releases gehen (rechte Seitenleiste auf GitHub) und die neueste btc-tracking.jar herunterladen.
Terminal im Download-Ordner öffnen.
App starten:
```
java -jar btc-tracking.jar
```
Browser öffnet automatisch http://localhost:8080/btc-tracking. Daten werden standardmäßig in btc-tracking-data.mv.db neben der JAR gespeichert (H2, dauerhaft) — diese Datei sichern, um Daten zu behalten.

Variante 2 — Portables ZIP für Windows (kein Java nötig)

Enthält eine gebündelte JRE — keine separate Java-Installation erforderlich.

Im Repository unter Releases das ZIP für Windows herunterladen (enthält gebündelte JRE + Launcher).
ZIP vollständig entpacken (nicht nur öffnen — die JRE muss mit extrahiert werden).
Im entpackten Ordner die BtcTracking.exe (bzw. das .bat-Startskript) ausführen.
Server startet lokal auf Port 8080, Browser öffnet automatisch http://localhost:8080/btc-tracking.

ℹ Hinweis: Details zu weiteren Setup-Varianten (In-Memory ohne Persistenz, MySQL-Anbindung, Build aus dem Quellcode mit ./gradlew bootJar) stehen im README des Repositories.

OPTION B

Installation auf Umbrel

Die App lässt sich auch als App auf einer Umbrel-Node installieren — über einen eigenen Community App Store, keine Aufnahme im offiziellen Umbrel App Store nötig.

github.com/thatsme4now/thatsme4now-umbrel-apps Community App Store · enthält die App „thatsme4now-btc-tracking“

Repository öffnen ↗

In der umbrelOS-Oberfläche zum App Store gehen und den Bereich für Community App Stores öffnen (dort können externe Store-URLs hinzugefügt werden).

Als URL eintragen:

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

Store hinzufügen — Umbrel lädt die enthaltenen Apps aus dem Repository.
Die App „BTC Tracking“ aus diesem Community Store auswählen und wie jede andere Umbrel-App installieren.
Nach der Installation ist die App über das Umbrel-Dashboard erreichbar, Daten bleiben persistent auf der Umbrel-Node.

ℹ Hinweis: Community App Stores sind eine reguläre Umbrel-Funktion für Apps außerhalb des offiziellen Stores. Genaue Menüpfade können sich je nach umbrelOS-Version leicht unterscheiden.

OPTION C

Installation per Docker

Die App ist auch als Docker-Image verfügbar — läuft isoliert, ohne lokale Java-Installation.

hub.docker.com/r/thatsme4now/btc-tracking Docker-Image der App

Docker Hub öffnen ↗

Voraussetzung: Docker installiert (z. B. Docker Desktop unter Windows).

Terminal bzw. PowerShell öffnen.

Container starten:

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

App unter http://localhost:8080/btc-tracking im Browser öffnen.

ℹ Persistenz: Das Named Volume btc-tracking-data hält die Daten über Neustarts und Image-Updates hinweg. Für ein Update reicht docker pull thatsme4now/btc-tracking:latest gefolgt von einem Neustart des Containers — das Volume bleibt erhalten.

OPTION D

Installation per Proxmox

Kein dediziertes Proxmox-Template — der Betrieb erfolgt über eine normale VM oder LXC-Container auf der Proxmox-Node, in der Docker installiert ist. Danach gilt derselbe Ablauf wie unter Option C.

Auf der Proxmox-Node eine VM oder ein (privilegiertes oder unprivilegiertes) LXC anlegen, z. B. mit Debian/Ubuntu.
In der VM/LXC Docker installieren.
Den docker run-Befehl aus Option C in der VM/LXC ausführen.
App über die IP der VM/LXC erreichen: http://<VM-IP>:8080/btc-tracking.

ℹ Hinweis: Bei LXC ist verschachteltes Docker (Nested Virtualization) nötig — in Proxmox über die Option Features → Nesting am Container aktivieren, bevor Docker installiert wird.

ÜBERBLICK

Welche Variante passt?

Variante	Voraussetzung	Geeignet für
JAR	Java 21+ installiert	Linux/Mac/Windows, wer Java bereits nutzt
Portables Windows-ZIP	Keine — JRE ist enthalten	Windows ohne Java-Installation
Umbrel	Laufende Umbrel-Node	Dauerbetrieb auf eigener Hardware/Server, zusammen mit anderen Umbrel-Apps
Docker	Docker installiert (z. B. Docker Desktop unter Windows)	Isolierter Betrieb ohne lokale Java-Installation, einfache Updates per Image-Pull
Proxmox	Proxmox-Node, VM/LXC mit Docker	Dauerbetrieb auf eigener Proxmox-Infrastruktur