Public | Automated Build

Last pushed: 9 months ago
Short Description
PXE server to deploy Rancher OS thinclients
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

The only configuration necessary is to edit the .env file, which defines CONFIGHOST and CONFIGPORT.

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