elie/docker-idrac6
1
0
Fork 0
mirror of https://github.com/DomiStyle/docker-idrac6.git synced 2024-12-22 05:45:22 +01:00
Code Issues Packages Projects Releases Wiki Activity
iDRAC 6 web interface and VNC proxy
31 Commits 8 Branches 9 Tags 3.1 MiB
C 61.7%
Shell 29.8%
Dockerfile 8.5%
27059eba65
Go to file
Dominik 27059eba65
Merge pull request #40 from m-bers/master 
Updates, fixes, changes
2022-02-28 21:58:43 +01:00
.gitignore Add support for Docker secrets 2020-01-08 13:05:23 +01:00
docker-compose.yml Add support for Docker secrets 2020-01-08 13:05:23 +01:00
Dockerfile Update to debian-11 baseimage, set display resolution to reduce black space, switch to Zulu JDK-11, add Dell iDRAC icon 2022-02-28 12:09:22 -08:00
icon.png Update to debian-11 baseimage, set display resolution to reduce black space, switch to Zulu JDK-11, add Dell iDRAC icon 2022-02-28 12:09:22 -08:00
keycode-hack.c add keycode hack 2019-03-22 15:54:41 +01:00
LICENSE Initial commit 2018-04-05 08:32:52 +02:00
README.md Add documentation for keycode hack 2019-04-03 09:41:54 +02:00
startapp.sh Add support for Docker secrets 2020-01-08 13:05:23 +01:00

README.md

iDRAC 6 dockerized

Web interface Web interface

Guacamole Directly connected to VNC via Guacamole

About

Allows access to the iDRAC 6 console without installing Java or messing with Java Web Start. Java is only run inside of the container and access is provided via web interface or directly with VNC.

Container is based on baseimage-gui by jlesage

Usage

See the docker-compose here or use this command:

docker run -d -p 5800:5800 -p 5900:5900 -e IDRAC_HOST=idrac1.example.org -e IDRAC_USER=root -e IDRAC_PASSWORD=1234 domistyle/idrac6

The web interface will be available on port 5800 while the VNC server can be accessed on 5900. Startup might take a few seconds while the Java libraries are downloaded. You can add a volume on /app if you would like to cache them.

Configuration

Variable Description Required
IDRAC_HOST Host for your iDRAC instance. Make sure your instance is reachable with https://<IDRAC_HOST>. See IDRAC_PORT for using custom ports. HTTPS is always used. Yes
IDRAC_USER Username for your iDRAC instance. Yes
IDRAC_PASSWORD Password for your iDRAC instance. Yes
IDRAC_PORT The optional port for the web interface. (443 by default) No
IDRAC_KEYCODE_HACK If you have issues with keyboard input, try setting this to true. See here for more infos. No

For advanced configuration options please take a look here.

Volumes

Path Description Required
/app Libraries downloaded from your iDRAC instance will be stored here. Add a volume to cache those files for a faster container startup. No
/vmedia Can be used to allow virtual media to be mounted. No
/screenshots Screenshots taken from the virtual console can be stored here. No

Make sure the container user has read & write permission to these folders on the host. More info here.

Issues & limitations

  • ~Libraries are not loaded correctly~
    • ~Causes error message on start~
    • ~"Pass all keystrokes to server", "Single Cursor" and "Virtual Media" is not available until fixed~
  • User preferences can't be saved
  • VNC starts with default 1024x768 resolution instead of fullscreen
    • Use "View" -> "Full Screen" to work around this issue
  • Keyboard layout can't be changed
  • Only one iDRAC server can be accessed with a single instance
    • Run multiple containers to work around this issue (e.g. srv1.idrac.example.org, srv2.idrac.example.org)