szabis/iventoy Docker Image

iVentoy

A Docker image running iVentoy.

iVentoy is a complete PXE boot server that includes the necessary services to enable computers to boot over network.

If you don't know what PXE, DHCP or TFTP is, don't try it!

It is recommended to use with a third-party DHCP Server iVentoy and Thirdy-part DHCP Server

What's new

• iVentoy updated to 1.0.44 version.
• Fix issue that Fedora boot hang with custom iSCSI port number.
• Fix the crash when there exist some special ISO file.
• Improvement for DHCP Relay.

Previous release changelog: changelog.szabis.hu. For more information please visit: https://github.com/ventoy/PXE.

First start

Important: on the first start run the container with AUTO_START_PXE=false.

The shipped default config has the internal DHCP server enabled. With auto start turned on the PXE service tries to come up with that setting and fails, so the container does not start.

1. Start the container with AUTO_START_PXE=false.
2. Open the WebUI at http://<host-ip>:26000 and set the DHCP mode you want to use (e.g. external DHCP server), then save the configuration.
3. Set AUTO_START_PXE=true and recreate the container.

Command line startup:

This container must be run as root.

On the first start use AUTO_START_PXE=false, see First start.

bash
docker run -d --name iventoy \
  --network host \
  --privileged \
  --restart on-failure:3 \
  --health-cmd="curl --fail --silent --head http://localhost:26000/ || exit 1" \
  --health-interval=30s \
  --health-timeout=10s \
  --health-retries=3 \
  --health-start-period=2m \
  -e AUTO_START_PXE=true \
  -e TZ=Your timezone \
  -v /path/to/data:/opt/iventoy/data \
  -v /path/to/driver:/opt/iventoy/driver \
  -v /path/to/iso:/opt/iventoy/iso \
  -v /path/to/log:/opt/iventoy/log \
  -v /path/to/user:/opt/iventoy/user \
  -p 67:67/udp \
  -p 69:69/udp \
  -p 3260:3260/tcp \
  -p 10445:10445/tcp \
  -p 10809:10809/tcp \
  -p 12049:12049/tcp \
  -p 16000:16000/tcp \
  -p 26000:26000/tcp \
  szabis/iventoy:latest

Docker Compose

This container must be run as root.

On the first start use AUTO_START_PXE=false, see First start.

yaml
version: '3.9'
services:
  iventoy:
    image: szabis/iventoy:latest
    network_mode: "host"
    container_name: iVentoy
    hostname: iventoy
    healthcheck:
      test: ["CMD", "curl", "--fail", "--silent", "--head", "http://localhost:26000/"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 2m
    privileged: true # must be true
    environment:
      - AUTO_START_PXE=true
      - TZ=Your timezone
    ports:
      - "67:67/udp" # DHCP Server
      - "69:69/udp" # TFTP Server
      - "3260:3260" # iSCSI Server
      - "10445:10445" # SMB Server (Samba)
      - "10809:10809" # NBD Server (NBD)
      - "12049:12049" # NFS Server
      - "16000:16000" # PXE Service HTTP Server (iVentoy PXE Service)
      - "26000:26000" # PXE GUI HTTP Server (iVentoy GUI)
    volumes:
      - /path/to/data:/opt/iventoy/data
      - /path/to/driver:/opt/iventoy/driver
      - /path/to/iso:/opt/iventoy/iso
      - /path/to/log:/opt/iventoy/log
      - /path/to/user:/opt/iventoy/user
    restart: on-failure:3