Public | Automated Build

Last pushed: 2 years ago
Short Description
CoreOS PXE Cluster Boot (under development)
Full Description


Docker image for setting up an CoreOS PXE server

This repository is a proof of concept only - don't use in production!

Thanks to

This Project is build upon the work of Quanlong He docker-coreos-pxe-installer
but instead of installing CoreOS on a device, this project boots
CoreOS und builds the cluster without any harddrives needed.


This docker image will:

  • Listen for dhcp offers on the first network interface (or configured)
  • add pxeboot-options to the dhcp offers
  • download the current CoreOS image from mirror
  • offer the pxe-images per tftp for network-booting
  • provide a configuration-webservice on port 888
  • distribute your ssh public-key to all the nodes
  • Will be started on as fleet-service inside the cluster so there is no single point of failure.

Running the Image

What you'll need:

  • A properly configured and running DHCP Server offering ipv4 addresses (coreos-pxe acts in DHCP Proxy mode)
  • At least 2 Nodes with network-cards configured in PXE mode and boot from network

Start the PXE-Service:

docker pull dermatthes/coreos-pxe
docker run --net=host -e MODE=BOOTSTRAP -e INTERFACE=eth2 -v /root/.ssh/ --name corepxe dermatthes/coreos-pxe

This will create a initial cluster with 3 nodes. It will create a
ssh private/publickey for inter cluster authentication (for user core)

Then start the first node. Wait until its online. You'll see the

You can log into the node by using public-key auth:

ssh core@<ip>

Switching to Cloud-Powered service:

Login to first node and execute (as root)

eval `ssh-agent -s`

after that you can use fleetctl:

fleetctl start /bootpxe/coreos-pxe.service

After that you can turn off your initial pxe node and reboot in pxe-mode
to join the cluster.


Monitoring the cluster health

etcdctl cluster-health
etcdctl member list

remove a failed node

etcdctl member remove <id>
Docker Pull Command
Source Repository