v1.3.0

What's new

Built-in web terminal: open an interactive shell inside any running container straight from the browser (docker exec over WebSocket + xterm.js). No more SSH-ing into the host just to poke around inside a container. Auto-detects bash/sh, and shows a clear message if a container has no shell at all.

One-click image update: the "Update" badge is no longer just a read-only flag. Click it and Servedash pulls the new image and recreates the container with its current config (ports, volumes, env, networks). Before touching anything, it classifies the update:

• ✅ Safe: not managed by docker-compose or a Portainer stack, no custom networking. One click, no extra confirmation.
• ⚠️ Risky: compose-managed, Portainer-managed, or has custom networking. Servedash explains exactly why and requires you to check "I understand the risk, update anyway" before proceeding.

If a recreate fails partway through, Servedash restores the original container rather than leaving you with neither.

⚠️ Security-relevant change

The Docker socket mount changes from read-only to read-write in docker-compose.yml — required for docker exec and image recreate/removal. This is equivalent to root on the host. If you're upgrading, update your compose file's volume line and keep Servedash off the public internet, same as before but now more so.

Upgrading

git pull
docker compose up -d --build
Make sure your docker-compose.yml mounts /var/run/docker.sock:/var/run/docker.sock (no :ro).

v1.3.0 发布说明

更新内容

内置网页终端： 直接在浏览器里打开任意运行中容器的交互式 shell(通过 WebSocket 跑 docker exec + xterm.js),不用再为了看一眼容器里面的东西专门 SSH 到宿主机。自动探测 bash/sh,容器里完全没有 shell 的话也会给出清楚的提示。

一键镜像更新： "Update" 徽章不再只是只读提示了。点一下,Servedash 会 pull 新镜像,并用当前容器的配置(端口、volume、环境变量、网络)重建容器。在改动任何东西之前,会先做风险分类:

• ✅ 安全：不是 docker-compose 或 Portainer stack 管理的、没有自定义网络配置。一键完成,不需要额外确认。
• ⚠️ 有风险：compose 管理、Portainer 管理,或有自定义网络配置。Servedash 会说明具体原因,需要勾选"我理解风险,仍然更新"才会继续。

如果重建过程中途失败,Servedash 会恢复原容器,不会让你两边都没有。

⚠️ 涉及安全性的改动

Docker socket 挂载方式从只读改成了读写(docker-compose.yml)——内置终端和镜像重建/删除都需要这个权限,等同于宿主机的 root 权限。升级的话记得把你自己的 compose 文件里 volume 那行也改一下,并且继续保持不暴露在公网上。

升级方法

git pull
docker compose up -d --build
确认你的 docker-compose.yml 里 socket 挂载是 /var/run/docker.sock:/var/run/docker.sock(不带 :ro)。

v1.2.1

Fixed

• CPU/Memory bar colors now follow load tiers as documented: green under 80%, yellow 80-89%, red 90%+. Previously CPU always showed blue and Memory always showed orange under normal load. Reported by @bcurran3 in #3
• List view status badge and CPU/Memory values now update on auto-refresh (previously only grid view updated)

修复

• CPU/内存条颜色现在按负载分级显示:80% 以下绿色,80-89% 黄色,90% 以上红色。此前正常负载下 CPU 恒为蓝色、内存恒为橙色。感谢 @bcurran3 反馈 #3
• 列表视图的状态徽章和 CPU/内存数值现在会随自动刷新更新(此前仅网格视图更新)

Upgrade

​ docker pull ghcr.io/destinyjazz/servedash:latest ​

Servedash v1.2.0

Servedash v1.2.0

A bigger release focused on status visibility, smoother refreshes, and container controls. Thanks to @bcurran3 for the detailed feedback that shaped most of this.

What's new

• Unhealthy detection. Containers that are running but failing their Docker healthcheck now show as "Unhealthy" instead of "Running", with a distinct orange status.
• Smarter refresh. Auto-refresh now updates the data in place instead of re-rendering the whole page. No more flicker, and your scroll position, drag order, and open menus are preserved.
• Pause and unpause. You can now pause and unpause containers from the dashboard.
• Actions menu. Container controls (Start, Restart, Pause, Unpause, Stop) are grouped into a single Actions dropdown that only shows what's valid for the current state. Open and Logs stay as direct buttons.
• Status filter. The status filter is now a dropdown with Running, Stopped, Paused, and Unhealthy, each with a live count.
• CPU and memory bar colors. Usage bars change color by load: green under 80%, yellow 80 to 90%, red above 90%.
• Version in the UI. The current version shows next to the Servedash logo and links to the release notes. The logo is now clickable to refresh the page.
• Self-update hint. If a newer Servedash image is available, the version tag is highlighted.
• Startup log. On start, Servedash now prints its version and active configuration to the container log.

Notes

• Pausing a container keeps it in memory and stops its processes; unpausing resumes it. This is different from stopping.
• Update detection and the rest of the v1.1.0 features are unchanged.

Upgrading

Pull the new image and recreate the container. No configuration changes are required. To persist drag order, make sure a volume is mounted at /app-data.

---

Servedash v1.2.0（中文）

这是一个较大的版本，重点在状态可见性、更顺滑的刷新，以及容器控制。感谢 @bcurran3 的详细反馈，这一版大部分内容都源于此。

新功能

• Unhealthy 检测。 正在运行但 Docker 健康检查失败的容器，现在显示为「Unhealthy」而不是「Running」，用醒目的橙色标示。
• 更智能的刷新。 自动刷新现在原地更新数据，而不是整页重画。不再闪烁，滚动位置、拖拽顺序、已展开的菜单都会保留。
• 暂停与恢复。 现在可以从面板暂停（pause）和恢复（unpause）容器。
• 操作菜单。 容器控制（Start、Restart、Pause、Unpause、Stop）收进一个 Actions 下拉，只显示当前状态下可用的操作。Open 和 Logs 仍是独立按钮。
• 状态筛选。 状态筛选改为下拉，包含 Running、Stopped、Paused、Unhealthy，各自带实时计数。
• CPU 和内存条变色。 使用率条按负载变色：低于 80% 绿色，80 到 90% 黄色，高于 90% 红色。
• 界面显示版本号。 当前版本显示在 Servedash logo 旁，并链接到 release notes。logo 现在可点击刷新页面。
• 自更新提示。 如果有更新的 Servedash 镜像，版本标签会高亮。
• 启动日志。 启动时，Servedash 会把版本和当前配置打印到容器日志。

说明

• 暂停容器会保留它在内存中并停止其进程，恢复后继续运行。这与停止（stop）不同。
• 更新检测和 v1.1.0 的其他功能保持不变。

升级

拉取新镜像并重建容器，不需要改任何配置。要保留拖拽顺序，请确认挂载了卷到 /app-data。

Servedash v1.1.0

Servedash v1.1.0

New features and improvements based on community feedback.

What's new

• Image update detection. Servedash now checks if a newer image is available and shows an "Update" badge on the container card. Supports public images on Docker Hub, GHCR, and lscr.io. Click the cloud icon in the header to check, or set UPDATE_CHECK_INTERVAL to check automatically.
• Drag to reorder. Grab any container card and drop it where you want. Your order is saved and persists across restarts.
• Sorting. Sort containers by name, uptime, or update availability.
• Custom URL labels. Now reads servedash.url, with fallback to homepage.href for Homepage compatibility. The old dashboard.url still works.
• Healthcheck. The container now reports a health status.
• New icon. Added a proper Servedash icon and favicon.

New environment variables

• REFRESH_INTERVAL (seconds) controls auto-refresh of container status. 0 = off.
• UPDATE_CHECK_INTERVAL (minutes) controls how often image updates are checked. 0 = manual only.

Notes

• Update detection is read-only. It tells you when an update exists but does not change your containers.
• Only public images on Docker Hub, GHCR, and lscr.io are checked. Private and other registries show as unsupported.
• To persist drag order, mount a volume at /app-data. See the updated docker-compose.yml.

---

Servedash v1.1.0（中文）

根据社区反馈带来的新功能和改进。

新功能

• 镜像更新检测： Servedash 现在会检查是否有新版本镜像,有的话在容器卡片上显示 "Update" 标记。支持 Docker Hub、GHCR、lscr.io 上的公开镜像。点 header 的云图标手动检查,或设置 UPDATE_CHECK_INTERVAL 自动检查。
• 拖拽排序： 抓住任意容器卡片拖到想要的位置。顺序会保存,重启后保留。
• 排序： 可按名称、运行时间、是否有更新排序。
• 自定义 URL 标签： 现在读取 servedash.url,并支持回退到 homepage.href(兼容 Homepage)。旧的 dashboard.url 仍然有效。
• 健康检查： 容器现在会上报健康状态。
• 新图标： 加入了 Servedash 图标和 favicon。

新增环境变量

• REFRESH_INTERVAL(秒)控制容器状态自动刷新。0 = 关闭。
• UPDATE_CHECK_INTERVAL(分钟)控制镜像更新检查频率。0 = 只手动。

说明

• 更新检测是read-only的,只告诉你有更新,不会改动你的容器。
• 只检查 Docker Hub、GHCR、lscr.io 上的公开镜像。私有和其他 registry 显示为不支持。
• 要保留拖拽顺序,需挂载一个卷到 /app-data,参考更新后的 docker-compose.yml。

v1.0.1

Servedash v1.0.1

Minor update.

Changes

• ✨ Added a GitHub link in the header for quick access to the repo
• ✨ Added a footer with license and project info
• 🔗 Improved port handling — when a container exposes multiple ports, Open now shows a picker so you can choose the right one

---

Servedash v1.0.1

小版本更新。

更新内容

• ✨ 在 header 添加 GitHub 链接,方便快速跳转到仓库
• ✨ 添加底部 footer,显示许可证和项目信息
• 🔗 改进端口处理 —— 容器有多个端口时,Open 会弹出选择菜单,让你选对的那个