Repository navigation
Releases
Releases · Erreur32/TopviewR
TopviewR v1.4.0
Ships btop 1.4.8, htop 3.5.3, nvtop 3.3.2 and ttyd 1.7.7 on Alpine 3.24, for linux/amd64 and linux/arm64; and the new :nvidia image on Debian 13 (htop 3.4.1), for linux/amd64.
Added
- NVIDIA GPUs: new
:nvidiaimage (Dockerfile.nvidia), on Debian because NVIDIA'slibnvidia-mlis built for glibc and crashes btop and nvtop on Alpine. Same scripts, tests and hardening; use it withruntime: nvidia. It also works with AMD, Intel or no GPU. Tested on an RTX 3060 Ti (nvtop: usage, VRAM, temperature, power, processes; btop: GPU meter) and on an AMD Radeon 8060S. - Startup header: NVIDIA GPUs in the GPU line, and the image base (Alpine or Debian).
Changed
- Esc menu: Esc a second time now sends a real Esc to the tool, so btop's own menus (Options, Help, Quit) close as usual;
qonly closes the TopviewR menu, andxcloses the session (wasq, the tools' own quit key, easy to hit by mistake).mis gone. - nvtop without a usable GPU is no longer started: the message says what to mount (
/dev/drifor AMD/Intel, the:nvidiaimage for NVIDIA), and names the:nvidiaimage when the Alpine image sees an NVIDIA card.
TopviewR v1.3.0
Ships btop 1.4.8, htop 3.5.3, nvtop 3.3.2 and ttyd 1.7.7 on Alpine 3.24, for linux/amd64 and linux/arm64.
Security
- The password no longer shows in the container logs: at startup ttyd printed
credential: <base64 of user:pass>, which anyone readingdocker logs(Dozzle, Portainer...) could decode.ttyd-cred.cnow masks that line, and it is no longer printed at the default log level anyway.tests/test.shchecks the base64 form too. Present since 1.0.0.
Added
- Startup header in the logs: version, URL, auth mode (user name only), TLS, menu, UID/GID, log level, and a host summary (CPU, RAM, GPU render nodes, tool versions).
BTOP_DEBUG:truebrings back ttyd's notices (each connection, startup config).
Changed
- Quiet logs by default: ttyd only logs errors and warnings (refused origins stay visible), instead of six libwebsockets lines per request.
TopviewR v1.2.1
Ships btop 1.4.8, htop 3.5.3, nvtop 3.3.2 and ttyd 1.7.7 on Alpine 3.24, for linux/amd64 and linux/arm64.
Security
- The password no longer shows in
pson the host: ttyd only takes it as-c user:pass, so withpid: hostany account on the server (and the process lists of btop and htop) could read it. ttyd now gets-c TTYD_CREDENTIALand a smallLD_PRELOADshim (ttyd-cred.c, built with the image) hands it the value from its environment, which only root can read. Without the shim ttyd refuses to start, it never runs without a password.tests/test.shchecks every command line. Present since 1.0.0.
TopviewR v1.2.0
Ships btop 1.4.8, htop 3.5.3, nvtop 3.3.2 and ttyd 1.7.7 on Alpine 3.24, for linux/amd64 and linux/arm64.
Added
- Alt+1, Alt+2, Alt+3 switch tools at once (btop, htop, nvtop), without opening the menu; the shortcuts are shown in the bottom bar and in the Esc menu. They work with or without Shift (AZERTY keyboards). Plain digits stay with the tools.
- Project logos in the README: btop, htop and nvtop logos next to their names in "Built on", copied unmodified from their repositories.
Fixed
- Closing the browser tab now ends the session: with the hardened compose (
cap_drop: ALL), ttyd (root) was not allowed to signal the non-root tool, so every closed tab left tmux and btop, htop or nvtop running for good. A small rootshnow sits between ttyd and the tool; ttyd stops it and the session ends with it. Present since 1.0.0.tests/test.shchecks it with the hardened capabilities.
TopviewR v1.1.0
Renamed from btop-web to TopviewR. Ships btop 1.4.8, htop 3.5.3, nvtop 3.3.2 and ttyd 1.7.7 on Alpine 3.24, for linux/amd64 and linux/arm64.
Added
- htop and nvtop:
BTOP_TOOL=htoporBTOP_TOOL=nvtopruns htop 3.5.3 or nvtop 3.3.2 instead of btop, with the same login, TLS and non-root protection. nvtop is compiled from source (checksum verified), it is not in Alpine stable. Their settings are saved in the config volume (htop/,nvtop/). - Switch tools from the browser: a bottom bar with clickable
btop,htop,nvtop, andEscopens a switch menu on top of any tool (mstill sends Esc to the tool, so btop's own menu stays reachable). Built on a locked-down tmux with every default binding removed: it cannot open a shell.BTOP_MENU=falsekeeps the old behavior. - Passwords removed from the tools environment: htop's environment view could show
BTOP_PASS. - Third-party licenses in the image: license texts of btop, htop, nvtop and ttyd in
/usr/local/share/licenses/, sources and licenses listed in the README; the image license label now readsApache-2.0 AND GPL-2.0-or-later AND GPL-3.0-or-later AND MIT AND ISC. - GPU access for the non-root monitor: when
/dev/dri/renderD*is mounted, the monitor runs with its group (usuallyrender) unlessBTOP_GIDis set. - TopviewR logo, favicon and page title: the browser tab shows the TopviewR icon; the page is ttyd's own, taken from the installed ttyd at build time so it always matches its version. The default tab title is
TopviewR @ <hostname>. - htop Black Night theme by default: until another theme is picked in htop (F2, Colors), it is then saved in the config volume.
Changed
- Renamed to TopviewR: the repository is now
Erreur32/TopviewR(the old address redirects) and the imageghcr.io/erreur32/topviewr. The old image nameghcr.io/erreur32/btop-webstill gets the same builds for now: only theimage:line has to change, allBTOP_*variables stay the same. - Bigger text: default font size is now 16 (
BTOP_FONT_SIZE).
Fixed
- btop settings when another tool is the default:
btop.confis created whateverBTOP_TOOLis, since the menu can start btop from htop or nvtop.
btop-web v1.0.0
First release. Ships btop 1.4.8 and ttyd 1.7.7 on Alpine 3.24, for linux/amd64 and linux/arm64.
Added
- btop in the browser: btop compiled from source (checksum verified, GPU support), served by ttyd.
- Drop-in replacement for
bigbeartechworld/big-bear-btop: the oldGOTTY_AUTH_*variables still work, so only theimage:line of an existing compose file changes. - Hardened defaults: btop runs as UID 10001 and cannot signal host processes, a password of at least 12 characters is required, WebSocket origin is checked, 3 sessions max.
- Built-in HTTPS:
BTOP_TLS=autogenerates a self-signed certificate kept in/certs. - Hardened compose (
docker-compose.yaml): noprivileged,cap_drop: ALLplus 3 capabilities, read-only root filesystem, real host network and disks. - Local test server:
scripts/dev.shbuilds the tree and runs it on port 7682 with the logs in the foreground. - Automation: weekly rebuild with a Trivy scan, a PR when a new btop release is out, Dependabot, GitHub release on each tag.
Fixed
- arm64 build: btop only compiles its Intel GPU sources on x86_64; they are now enabled on every architecture so the link no longer fails.
- Zombie processes: with
pid: hosttini is not PID 1;TINI_SUBREAPER=1lets it reap them (and removes the startup warning).