A Docker container for connecting to Supermicro Java based iKVM Viewers, built from jlesage/docker-baseimage-gui. See Disclaimers & Current Bugs before using.
version: '3.8'
services:
supermicro-java-ikvm:
image: ghcr.io/mistercalvin/supermicro-java-ikvm:latest
container_name: supermicro-java-ikvm
environment:
TZ: UTC
USER_ID: 1000
GROUP_ID: 1000
KVM_HOST: # IP or Hostname
KVM_USER: # Your IPMI Username
KVM_PASS: # Your IPMI Password
DISPLAY_WIDTH: 1024 # Display Width
DISPLAY_HEIGHT: 768 # Display Height
ports:
- 5800:5800 # Web UI Port
- 5900:5900 # VNC Port
volumes:
- ./vmedia:/app/vmedia/ # Virtual Media ISO's
- ./screenshots:/app/screenshots/ # Screenshots / Recordings
- supermicro-java-ikvm:/config/ # Persistent Configuration for user preferences
restart: no
volumes:
supermicro-java-ikvm:
name: supermicro-java-ikvm
Create a named volume before executing the command below: docker volume create supermicro-java-ikvm (this will persist user preferences and iKVM .jar files)
docker run -d \
--name=supermicro-java-ikvm \
-e TZ="UTC" \
-e USER_ID="1000" \
-e GROUP_ID="1000" \
-e KVM_HOST="" \
-e KVM_USER="" \
-e KVM_PASS="" \
-e DISPLAY_WIDTH="1024" \
-e DISPLAY_HEIGHT="768" \
-p 5800:5800 \
-p 5900:5900 \
-v ./vmedia:/app/vmedia/ \
-v ./screenshots:/app/screenshots/ \
-v supermicro-java-ikvm:/config/ \
--restart no \
ghcr.io/mistercalvin/supermicro-java-ikvm:latest
Once the container is online you can access the web interface via the default port of 5800. If you wish to password protect this page take a look here for steps on how to do so.
You can specify the UID & GID for the user (app) inside the container, see this page for more information.
-
The image has additional environment variables you can customize, take a look at this page for more information. I have not tested the container with any variables other than what is defined in this repo; use these at your own risk.
-
This container has been tested with the following hardware and firmware revision:
Supermicro X9DR3-F Motherboard (Nuvoton WPCM450 BMC), BMC Firmware 3.62 [SMT_X9_362.bin] -
Selecting Español or Korean from Options > Preference > Language Setting will cause a crash, and any attempts to reconnect to the Java viewer will fail. To fix this, login to your server's web interface, then navigate to Maintenance > iKVM Reset. If this does not work you can also reboot the IPMI unit by navigating to Maintenance > Unit Reset.
-
If you are having issues with the UI upon boot, navigate to Options > Preference > Window and uncheck "Auto-resize window."
-
Continuing on the previous point: not all user preferences are saved. Hotkeys, Mouse Settings, and Keyboard settings seem to persist, but all other customization options such as mounted Virtual Media or Video Settings will be lost and need to be changed again if the container is restarted.
-
The container assumes your server's web interface is accessible via port 80 or port 443. If you are using a non-standard port and are having issues connecting you may need to modify the initialization script at
build/rootfs/etc/cont-init.d/50-setup-ikvm.sh, specifically line 28,url="https://$KVM_HOST".
Walter Doekes for their ipmikvm-tls2020 script
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent