Skip to content

M3hran/instapxe

Repository files navigation

Quick reference:

What is instaPXE?

InstaPXE is a network management software, platform based on "Preboot eXecution Environment" layer, needed to send instructions to boot clients from a network/cloud repository instead of local. (reknown as MaaS) A Platform to operate, monitor, automate ops on clients in a network/cloud (public/private).

logo

How to use this image?

Use like you would any other image:

$ docker run -p 69:69 \
-v ./bootfiles:/instapxe/boot \
-v ./menufiles/mybios.menu:/instapxe/instapxe.menu \
-v ./menufiles/myuefi.menu:/instapxe/instapxe.menu64 \
instapxe/instapxe:latest

Ports:

  • 69
    this port is used for netboot/pxe access

Volumes:

  • /instapxe/boot
    place your kernel files to boot from in here
  • /instapxe/instapxe.menu
    map your bios menu here
  • /instapxe/instapxe.menu32
    map your uefi32 menu here if any
  • /instapxe/instapxe.menu64
    map your uefi64 menu here if any

Environment Variable:

  • HTTP_HOST=x.x.x.x
    you can set this variable to IP address of the HTTP host and use $HTTP_HOST variable in your menu to serve files via HTTP

  • NFS_HOST=x.x.x.x
    you can set this variable to IP address of the NFS host and use $NFS_HOST variable in your menu to serve files via NFS

Dependencies: (works with existing sites,setups)

  • DHCP (optional)
  • HTTP (optional)
  • NFS (optional)

road map (areas to contribute):

  • pipeline the builds, frontendjs
  • ...

Discord:

https://discord.gg/xVS2seHguK

License:

This image is free for non-commercial use. View license information for the software contained in this image. https://instapxe.com/eula

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published