Public | Automated Build

Last pushed: a year ago
Short Description
rancherOS pxe server that provides disk imaging containers to thin clients
Full Description

PXE server to deploy Rancher OS thinclients

Two default thin clients:

  • Imager: a disk imager container, to create dd images of hard drives
  • IPED: a image processer container, it extract content from dd images


  • mongodb server

A simple mongodb server must be running somewhere, but it is not included in this repository.

One simple way to do it is:

docker run --net=host mongodb


Two services must be configured:

  • tftp, which provides the pxe menu and the RancherOS boot images
  • a webserver, which provides cloud-init YAML configurations used by RancherOS

tftp config

Two environment variables must be set:


Those two variables refers to the public IP and port of the webserver container.


The webserver provides YAML files.
It uses the handlebars template engine, which substitutes {{{ }}} variables for valid data.

Those variables are set in cloud-config/config/default.json, and possibly overwritten at cloud-config/config/local.json.

The use of {{{ }}} variables is not strictly necessary, they can be replaced by simple text if desired.
A valid resulting YAML file is all that matters, but the default.json file helps.

If nothing fancy is being done, editting cloud-config/config/default.json should suffice.


docker-compose up -d
Docker Pull Command
Source Repository