Skip to content

Releases

TopviewR v1.4.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 13:03
c4047a7

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 :nvidia image (Dockerfile.nvidia), on Debian because NVIDIA's libnvidia-ml is built for glibc and crashes btop and nvtop on Alpine. Same scripts, tests and hardening; use it with runtime: 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; q only closes the TopviewR menu, and x closes the session (was q, the tools' own quit key, easy to hit by mistake). m is gone.
  • nvtop without a usable GPU is no longer started: the message says what to mount (/dev/dri for AMD/Intel, the :nvidia image for NVIDIA), and names the :nvidia image when the Alpine image sees an NVIDIA card.

TopviewR v1.3.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 19:16
7b5dc97

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 reading docker logs (Dozzle, Portainer...) could decode. ttyd-cred.c now masks that line, and it is no longer printed at the default log level anyway. tests/test.sh checks 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: true brings 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

Choose a tag to compare

@github-actions github-actions released this 05 Nov 14:03
10e4211

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 ps on the host: ttyd only takes it as -c user:pass, so with pid: host any account on the server (and the process lists of btop and htop) could read it. ttyd now gets -c TTYD_CREDENTIAL and a small LD_PRELOAD shim (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.sh checks every command line. Present since 1.0.0.

TopviewR v1.2.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 08:38
e2a48b3

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 root sh now sits between ttyd and the tool; ttyd stops it and the session ends with it. Present since 1.0.0. tests/test.sh checks it with the hardened capabilities.

TopviewR v1.1.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 23:49
902371d

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=htop or BTOP_TOOL=nvtop runs 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, and Esc opens a switch menu on top of any tool (m still 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=false keeps 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 reads Apache-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 (usually render) unless BTOP_GID is 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 image ghcr.io/erreur32/topviewr. The old image name ghcr.io/erreur32/btop-web still gets the same builds for now: only the image: line has to change, all BTOP_* 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.conf is created whatever BTOP_TOOL is, since the menu can start btop from htop or nvtop.

btop-web v1.0.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 22:27
c6043cb

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 old GOTTY_AUTH_* variables still work, so only the image: 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=auto generates a self-signed certificate kept in /certs.
  • Hardened compose (docker-compose.yaml): no privileged, cap_drop: ALL plus 3 capabilities, read-only root filesystem, real host network and disks.
  • Local test server: scripts/dev.sh builds 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: host tini is not PID 1; TINI_SUBREAPER=1 lets it reap them (and removes the startup warning).