ibrokethecloud / boots

The DHCP and iPXE server for Tinkerbell.

Home Page:https://tinkerbell.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Boots

Build Status

This services handles DHCP, PXE, tftp, and iPXE for provisions.

This repository is Experimental meaning that it's based on untested ideas or techniques and not yet established or finalized or involves a radically new and innovative style! This means that support is best effort (at best!) and we strongly encourage you to NOT use this in production.

Running Boots

As boots runs a DHCP server, it's often asked if it is safe to run without any network isolation; the answer is yes. While boots does run a DHCP server, it only allocates an IP address when it recognizes the mac address of the requesting device.

Local Setup

First, you need to make sure you have git-lfs installed:

# install "git-lfs" package for your OS. On Ubuntu, for instance:
# curl https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
# apt install git-lfs

# then run these two commands:
git lfs install
git lfs pull

Running the Tests

# make the files
make all
# run the tests
go test

Build/Run Boots

# run boots
./boots

You can use NixOS shell, which will have the Git-LFS, Go and others

nix-shell

Note: for mac users, you will need to comment out the line pkgsCross.aarch64-multiplatform.buildPackages.gcc in order for the build to work

About

The DHCP and iPXE server for Tinkerbell.

https://tinkerbell.org

License:Apache License 2.0


Languages

Language:Go 96.9%Language:Makefile 1.4%Language:C 0.9%Language:Shell 0.5%Language:Nix 0.2%Language:Dockerfile 0.1%Language:C++ 0.0%