Changelog¶
Each release of Pierside, newest first. Install a specific one with rdctl extension install ghcr.io/hemi131/pierside:<version>.
Unreleased¶
1.4.3 - 2026-11-18¶
- Terminals: Ctrl+S no longer freezes the shell. It used to stop all output until Ctrl+Q (the terminal's old flow control), which looked like a hung shell. Full-screen programs such as
nanostill get it. - Terminals (the server terminal of an SSH engine and a container's shell): right click works as in Windows Terminal: it copies the selected text, or pastes when nothing is selected.
- The server terminal of an SSH engine edits the command line by word, as a container's shell already did: Ctrl+Backspace and Ctrl+Delete delete a word, Ctrl+Left / Ctrl+Right move by word, and text is selected with Shift+arrows, by word with Ctrl+Shift+Left / Right, or to the line's ends with Shift+Home / End (then Ctrl+C copies it). On the command line a selection works as in an editor: Left / Right go to its start / end, Backspace / Delete remove it, typing or pasting replaces it, and Ctrl+X cuts it (the command line is found after a prompt ending in
$,#,>or%). Full-screen programs such asvimortopstill get the keys unchanged.
1.4.2 - 2026-11-18¶
- Alerts no longer spam. A problem is reported once while it goes on, with a reminder every two hours, instead of again every few minutes for each kind of trouble: a restart loop that also makes the container unhealthy is one alert, and a Swarm service whose tasks all fail (for example an image that doesn't exist) is one alert, not one per replica. Alerts arriving together are one message, desktop notifications come at most every 30 seconds, and the message has Mute 1 h and Pause all 15 min. See Alerts.
- Cancel switch on a slow server: pressed after Pierside had already connected (an overloaded server answers slowly, so the switch can finish while you reach for the button), it used to do nothing, and you then waited for the slow server to load. Now it takes you back to the engine you came from. Leaving a slow server is also quicker: Pierside waits at most 10 seconds to clean up there.
1.4.1 - 2026-11-06¶
- Rancher Desktop 1.25: the extension lost its own look (very large headings, uppercase buttons, default colours) because Rancher now provides a minimal theme of its own. Pierside uses its own theme again.
1.4.0 - 2026-10-31¶
- Root terminal (SSH engines): a switch in the terminal's header opens that server's terminal as root, through a privileged helper container. Off by default, remembered per server, and it asks before turning on. See Remote engines.
- A file or process action on a server (upload, delete, change permissions, save, end a process) could finish on the other server if you switched engines while it ran. It now stops with a message instead, also when a second window still shows the previous server.
- Cancel switch stops the switch you see, not whichever one happens to be connecting, and only one switch runs at a time in a window.
- A server setting (Root terminal, or using Docker where you have no permission) is refused if the active engine changed while you were answering, instead of landing on another server.
- Containers: the icons of containers inside a Compose project are no longer cut off after a column has been resized.
1.3.2 - 2026-10-28¶
- Server performance no longer scrolls sideways in a narrow window: the process list leaves out the Running, User, Disk and Container columns as it gets narrower (the command's tooltip shows what they would), and the charts and the switches at the top fit the width.
1.3.1 - 2026-10-19¶
- Switching away from an SSH engine whose server had been turned off could take minutes, and other engines seemed impossible to switch to meanwhile. Requests waiting for the lost server now get its answer together instead of each trying to reconnect in turn, and the switch no longer waits for clean-up on a server it can't reach.
- A switch to an engine that doesn't answer can be cancelled: Cancel switch in the engine menu, or Cancel in place of Switch on Manage engines and Engines at a glance.
- Server performance: on a narrow window, the "Order held" note no longer moves the process list down when it appears, which ended the hold at once.
1.3.0 - 2026-10-17¶
- Server performance (SSH engines, in the bottom bar): like
htopfor the server, with the container of each process. CPU, memory, disks and network with 10-minute charts, a note when something stands out (low memory, swapping, waiting for the disk, high load), and the processes sorted by CPU, memory or disk I/O, or grouped by container. Processes can be ended, forced to end or given a lower priority. Nothing has to be installed on the server. - Server alerts: switch on Alert me about this server to be told when an SSH server's memory is almost full, it keeps swapping, its load stays high, or a disk is almost full, checked every 30 seconds whichever engine is active.
- Security: a request to Pierside's local port that claimed to come from a development web page (
Origin: http://localhost:3000) was let in without the session token, so any program on your computer, or a web page served on that port, could get full access to Docker through it. Every request now needs the token. - Security: AI access accepted names such as
../containers/xfor images and networks, which reached other parts of the Docker API: an assistant could delete a container outside its scope or put a container on the host's network. Such names are refused now. - Fixed: AI access could start a container on the host's network when given that network's ID instead of its name.
- Fixed: switching off Watch in the background (or removing a watched engine) left its connection open and could stop the page from updating.
- Fixed: an unreachable engine could make healthy watched engines look unreachable too.
- AI access: environment values with spaces were only partly hidden in
container_run_command, andcompose_config/read_compose_filesshowed secrets; with "Show environment values" off, variables are no longer filled in, values in environment, build arguments, driver options, inline contents andx-blocks are hidden, andread_compose_filesshows the merged configuration instead of the raw files. A volume used by containers outside a connection's scope is no longer visible to it, and lists name only the containers it shares. Starting a container with a host folder mounted now counts as destructive for "ask before destructive actions". - Fixed: Swarm "task keeps failing" alerts never came on servers whose clock isn't set to UTC.
- Fixed: Engines at a glance showed 0 CPU / memory for engines with many containers (now what could be measured, marked "≥"), counted Kubernetes' and Pierside's own containers on the active engine, and could call a container "restarting" hours after it stopped.
- Fixed: switching engines removed Pierside's helper containers on the new engine instead of the old one, and left shells of the old engine running.
- Fixed: pruning volumes stopped running file downloads, Server files and disk measurements and debug shells.
- Fixed: after a brief connection drop (e.g. an SSH hiccup), logs repeated up to 1000 lines; a single failed check could mark a container "removed". Merged Compose logs now also start in time order across slow and fast services.
- Fixed: Images → Clean up → All unused also deleted the images of Rancher Desktop, Kubernetes and extensions without a running container.
- Fixed: Swarm stack delete reported success when nothing could be deleted; Compose Start all also started
docker compose runone-off containers; Copy docker run command wrote an invalid-p 127.0.0.1:80for ports with any host port and quoted a multi-word entrypoint as one word. - Fixed: a settings file that couldn't be read (engines, port forwards) was overwritten empty on the next change; it is now kept as a copy.
- Fixed: a second confirmation (e.g. two port conflicts when starting several containers) replaced the first, and the action then never finished.
- Fixed: in a file browser, a file that loaded slowly could show up, and be saved, under the name of the file clicked after it.
- Fixed: pausing a container ended its Exec shell and dropped unsaved changes in its Files tab; both now carry on after Resume.
- Fixed: logs of a container with a terminal (TTY) could clear or switch the log view's screen; only colours and links are kept from such codes now.
- Fixed: removing an AI connection that was set up "for this project folder only" left it registered in the assistant (for connections set up from now on).
- Fixed: closing the bottom Docker console left commands such as
logs -frunning; Ctrl+F no longer takes the key from a shell (vim, less); Images: deleting from an image's page warns about Rancher Desktop's images and removes only the tag shown; IPv6 port links; Swarm secrets and configs show load errors instead of spinning; cancelling a Compose run right after starting it works; lists catch up after the live connection was briefly lost.
1.2.0 - 2026-10-15¶
- Engines at a glance is its own page now, opened from the second line of the engine switcher at the top of the sidebar. It keeps itself up to date (every 30 seconds by default; 10 seconds to 5 minutes, or only on Refresh), shows the CPU and memory each engine's containers use, and a click on a problem opens the container on its engine.
- Watch an engine in the background: a switch on each engine's card. A watched engine's alerts (restart loops, out of memory, unhealthy, failing Swarm services) arrive while another engine is active, named with the engine, and you are told when it can't be reached and when it is back. Recent alerts from all engines are listed on the page.
- Command palette in the Exec tab: save the commands you type often under your own labels and run them in any container's shell with Commands or Ctrl+Shift+P. Each command either runs right away or is only typed so you can change it first, and can be offered everywhere, for an image (
postgres,mycorp/*) or for a Compose project / service. One list for all engines, in Rancher and in the separate window. - Fixed: with a search in the logs, every batch of new lines moved to the next match and scrolled there. The current match and the view now stay where they are; new matches are still highlighted.
- Fixed: containers started again and again by something other than Docker, such as a GitLab Runner's job containers, were reported as "keeps restarting" / "keeps crashing". Only containers that Docker itself restarts (restart policy
always,unless-stopped, oron-failureafter a failure) are reported now. - Fixed: on smaller screens, a tooltip near the right edge (such as Refresh on the Server disk page) could make the whole page jump a little to the left.
1.1.1 - 2026-10-11¶
- Fixed: desktop notifications never appeared inside Rancher Desktop on Windows. They are now shown through Rancher Desktop's own notification call there; the separate window keeps using the browser's.
1.1.0 - 2026-10-11¶
- Alerts: restart loops are found more reliably. A container whose command keeps finishing cleanly and being restarted is now reported too (with different advice than a crashing one), stopping and starting a container by hand is no longer mistaken for a crash, and slow loops (Docker waits up to a minute between attempts) are no longer missed. New: a Swarm service whose task keeps failing is reported, on any node. See docs/alerts.md.
- Desktop notifications for these alerts when Pierside is open but not in front; switch them on in the dialog behind the version number.
- Engines: At a glance. The Engines page shows for every engine whether it can be reached, how many containers run and which need attention, without switching to it.
- Server disk: the usual places. A list of where space usually goes on a server (Docker's data, container logs, the journal, package caches, temporary files, home folders), measured with one click.
- File editor: typing in large files is faster.
- Fixed: switching to the SSH engine that is already active (for example from a second window) broke its connection until you switched away and back.
- AI access, security:
- New containers can no longer reach host system folders through a symbolic link: a host path with a link in it is refused, and so is a path inside a folder that a container the assistant can reach mounts writable. The list of refused system folders now also has
/etc,/root,/usr,/boot,/bin,/sbin,/liband, on Windows, Rancher Desktop's WSL socket folder. - Answering an assistant's request for more access applies only to the request you saw: if the assistant changed its request meanwhile, nothing is granted and the new request is shown.
- Engine events no longer show Swarm service, secret and config names to a connection without the Swarm permission.
pruneof all unused images keeps the images of Rancher Desktop extensions and Kubernetes, as it promised.- Asking for a wider file path or name pattern than a connection has (e.g.
/app/**when it has/app/*) now reaches you instead of being answered "already allowed". - Adding an SSH engine shows the server's host-key fingerprint first; your password or key is sent only after you confirm it.
- Downloads from volumes, containers and server files fail visibly if they are cut short, instead of saving a shorter file; long downloads and uploads through Pierside's helper containers are no longer interrupted after a minute.
- Logs: lines are no longer dropped when a container writes to stdout and stderr at the same moment.
- Live views (logs, shell, stats, pull progress, terminal) reconnect by themselves after Pierside's backend restarts, instead of staying disconnected until Pierside is reopened.
- Port forwards to SSH engines follow a container that was recreated (new address or port), and go away when it is removed, instead of reaching whatever now has its old address.
- Server files: uploading into, or downloading from, a place your SSH user can't access asks whether Docker may be used, instead of showing "[object Object]".
- Containers: "Remove service" on a Swarm service asks first and reports the result.
- Cancelling
docker composeon an SSH engine stops it on the server; stopping Server disk stops its measurements there too.
1.0.0 - 2026-10-10¶
Pierside 1.0: next to Docker itself, it now also works with the server behind an SSH engine.
- Server files: with an SSH engine active, Server files in the bottom bar browses and edits the files of that server with the same file browser and editor, as your SSH user. Where that user has no permission but may use Docker, Pierside can work through a short-lived helper container instead (asked once per server, marked with a badge, read-only unless you change something).
- Server disk: next to it, Server disk shows how full the server's filesystems are and which folders take the space. Folders are measured one by one as you open them, at low priority, with a time limit and a stop button; folders you can't read can be measured through Docker. It only reads.
- Find by name in every file browser (containers, volumes, server files): typing narrows the current folder, Enter searches its subfolders.
- File editor:
- Review changes shows your edit as a diff before saving.
- Syntax errors in JSON and YAML are underlined, and Compose files are checked against the official Compose schema (bundled, nothing is downloaded).
- VS Code keyboard shortcuts (Ctrl+D, Alt+Up/Down, Ctrl+/, Ctrl+L and more).
- Bracket pair colours and indentation guides.
- AI access:
- Add to Claude Code / Add to Devin CLI registers a connection with one click, for all your projects or for one project folder you choose, through a small helper program Rancher Desktop installs with the extension. The dialog shows the command the button runs. Removing a connection also removes it from the assistant.
- The connection dialog is simpler, and says when a connection is trusted instead of promising a question that won't come.
- Containers: a Compose project that is partly running has a start button for its stopped containers next to Stop all, in the list and on the project page.
- Files in containers: a folder the container's user can't read now says "Permission denied" instead of looking empty.
- Docs: What works where lists what differs between the Pierside tab in Rancher Desktop and the separate window, and between the local engine and SSH engines, with the reason for each.
0.4.1 - 2026-10-07¶
- AI access: the connection dialog also shows the command for Devin CLI (
devin mcp add).
0.4.0 - 2026-10-07¶
- AI access: a built-in MCP server for assistants such as Claude Code, with 66 tools covering containers, files, Compose projects, images, volumes, networks, ports, engine information, clean-up and Swarm, on the local engine and on SSH engines. Each connection has its own limits: which engines and containers, which of 20 permissions, and which file paths; or "Allow everything". By default no secret is stored with the assistant: you allow each session in Pierside, or trust a connection for a period or for good, actions that change something can ask every time, and the assistant can ask you for more access when it needs it; an access token is available for unattended use. Calls are listed under Recent activity. See docs/ai-access.md.
- Troubleshooting: what to do when installing reports
invalid extension metadata.
0.3.0 - 2026-10-06¶
First release under the name Pierside.
- Containers: live list grouped by Compose project; start, stop, restart and delete for single containers, projects and selections; port links; port-conflict hints; health checks; alerts for containers that crash, restart in a loop or run out of memory.
- Container details: logs (search, timestamps, download, copy as Markdown), inspect, bind mounts, interactive shell, debug shell for containers without one, file browser, live stats.
- Compose: merged colour-coded logs; Up, Down, Pull and recreate and View configuration with the common flags; projects stay listed after
down. - Files: upload, edit in a code editor with syntax highlighting, delete and change permissions, in containers and volumes.
- Images: pull, run with options, layers, prune, copy to another engine.
- Volumes and networks: create, inspect and prune; connect and disconnect containers. Items that belong to Rancher Desktop extensions are hidden unless you show them, are skipped by Prune, and deleting one asks with a warning first.
- Disk usage: what takes space, with one-click cleanup.
- Ports: forward container ports to
localhost, also from remote servers. - Remote engines over SSH, each with its own name and colour.
- Swarm: stacks, services, tasks, nodes, secrets and configs.
- Terminal: Docker console locally, a full shell on SSH engines.
- Updates: the footer shows the version and tells you when a newer release exists; old Pierside images are removed automatically.