mirror of
https://github.com/pikvm/pikvm.git
synced 2026-03-02 18:16:56 -05:00
PiKVM v4.127 – Switch port labels cannot be edited or loaded from switch.yaml (UI stuck on “Host X”) #1093
Labels
No labels
component:documentation
help wanted
resolution:delayed
resolution:duplicate
resolution:fixed
resolution:invalid
resolution:rejected
resolution:wontfix
success story
type:bug
type:bug
type:feature
type:question
type:question
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
starred/pikvm-pikvm#1093
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @pilotjoe on GitHub (Dec 4, 2025).
Originally assigned to: @mdevaev on GitHub.
Describe the bug
After upgrading to PiKVM kvmd 4.127-1 on a v4 Plus, the HDMI switch works but port labels cannot be edited in the Web UI, and custom labels defined in switch.yaml are ignored.
The UI always shows “Host 1 / Host 2 / Host 3 / Host 4”. Clicking the gear icon pulls up the port settings dialog, but I can't select the Port name textbox, and changes don't stick.
No relevant errors appear in logs.
To Reproduce
Create /etc/kvmd/switch.yaml with labels, for example:
switch:
units:
- ports:
1:
title: "Workstation"
2:
title: "Office Laptop"
3:
title: "Server"
4:
title: "Media PC"
Ensure permissions are correct. I tried:
Owner kvmd:kvmd, mode 0644
Owner root:root, mode 0644
Neither worked.
Restart KVMD:
systemctl restart kvmd
Open the PiKVM Web UI → Switch tab.
Observed behavior:
Labels still appear as “Host 1…4”
The UI does not allow editing: clicking the Port name field briefly focuses it, then it immediately loses focus and any changes don’t stick
Expected behavior:
Custom labels defined in /etc/kvmd/switch.yaml should appear in the Web UI.
The UI should allow renaming ports using the gear icon and save those changes.
The runtime configuration (kvmd -m) should show merged label metadata under the switch: section.
Screenshots
N/A here, but I can supply them if needed.
Desktop (please complete the following information):
OS: Windows 10 / Windows 11 (reproduced on both)
Browser: Chrome 142, Edge 130
Version: Latest PiKVM Web UI as of Dec 2025
VNC client: Not used (only Web UI)
PiKVM info:
Raspberry Pi board version: RPi 4 (PiKVM v4 Plus)
PiKVM platform: v4plus-hdmi
Video capture type: HDMI → CSI bridge (tc358743)
KVMD version (pacman -Q | grep kvmd):
kvmd 4.127-1
kvmd-platform-v4plus-hdmi-rpi4 4.127-1
kvmd-webterm 0.50-1
uStreamer version (pacman -Q | grep ustreamer):
ustreamer 6.41-1
Linux kernel (uname -a):
Linux pikvm 6.12.56-1-rpi #1 SMP PREEMPT Sat Nov 8 15:47:08 UTC 2025 aarch64 GNU/Linux
Additional context
This issue occurs on a clean PiKVM v4 OS install with a configuration restored from backup.
The file /etc/kvmd/switch.yaml exists and is being read (confirmed via:
kvmd -m | sed -n '/switch:/,/media:/p'
The switch: section shows device and EDID info, but no label/port metadata.)
Editing labels in the Web UI doesn’t work: the Port name textbox appears greyed/locked, and focus is immediately lost when clicked.
No errors appear in:
journalctl -u kvmd
journalctl -u kvmd-janus
Other users on Discord / GitHub seem to be reporting similar behavior after the 4.126–4.127 updates, so this may be a regression in the Web UI or in how switch.yaml is merged/applied for v4 Plus.
@pilotjoe commented on GitHub (Dec 4, 2025):
Runtime config snippet (from kvmd -m | sed -n '/switch:/,/media:/p')
switch:
device: /dev/kvmd-switch
default_edid: /etc/kvmd/switch-edid.hex
ignore_hpd_on_top: false
media:
@mdevaev commented on GitHub (Dec 4, 2025):
Hello. It's already fixed, please update OS.
@mdevaev commented on GitHub (Dec 6, 2025):
Sup?
@mdevaev commented on GitHub (Dec 8, 2025):
Solved, I guess. Please let me know, if not.
@pilotjoe commented on GitHub (Dec 12, 2025):
My apologies, I thought I had everything up to date, there must Thank you. I updated the OS and as you said, it is fixed now! I am able to edit port names through the web UI, but not through changing /etc/kvmd/switch.yaml as described above. Should this method also work, or is editing via the UI the only supported method?
@mdevaev commented on GitHub (Dec 13, 2025):
There is no way to change port names via
switch.yaml, we don't have such config. Please don't use AI to get help on PiKVM. AI often hallucinates and gives out not only invalid, but also harmful advices. If you need help, it is better to consult the official documentation or the support chat.@pilotjoe commented on GitHub (Dec 15, 2025):
Thank you, much appreciated!