How to install Cozystack using PXE
How to install Cozystack using PXE
Install dependencies:
docker
kubectl
Netboot server
Start matchbox with prebuilt Talos image for Cozystack:
sudo docker run --name=matchbox -d --net=host ghcr.io/aenix-io/cozystack/matchbox:v0.14.1 \
-address=:8080 \
-log-level=debug
Start DHCP-Server:
sudo docker run --name=dnsmasq -d --cap-add=NET_ADMIN --net=host quay.io/poseidon/dnsmasq:v0.5.0-32-g4327d60-amd64 \
-d -q -p0 \
--dhcp-range=192.168.100.3,192.168.100.199 \
--dhcp-option=option:router,192.168.100.1 \
--enable-tftp \
--tftp-root=/var/lib/tftpboot \
--dhcp-match=set:bios,option:client-arch,0 \
--dhcp-boot=tag:bios,undionly.kpxe \
--dhcp-match=set:efi32,option:client-arch,6 \
--dhcp-boot=tag:efi32,ipxe.efi \
--dhcp-match=set:efibc,option:client-arch,7 \
--dhcp-boot=tag:efibc,ipxe.efi \
--dhcp-match=set:efi64,option:client-arch,9 \
--dhcp-boot=tag:efi64,ipxe.efi \
--dhcp-userclass=set:ipxe,iPXE \
--dhcp-boot=tag:ipxe,http://192.168.100.254:8080/boot.ipxe \
--log-queries \
--log-dhcp
Where:
192.168.100.3,192.168.100.199
range to allocate IPs from192.168.100.1
your gateway192.168.100.254
is address of your management server
Check status of containers:
docker ps
example output:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
06115f09e689 quay.io/poseidon/dnsmasq:v0.5.0-32-g4327d60-amd64 "/usr/sbin/dnsmasq -…" 47 seconds ago Up 46 seconds dnsmasq
6bf638f0808e ghcr.io/aenix-io/cozystack/matchbox:v0.14.1 "/matchbox -address=…" 3 minutes ago Up 3 minutes matchbox
Start your servers, now they should automatically boot from your PXE server.
Now, when they are booted to Talos Linux maintenance mode, you can use talos-bootstrap or Talm to bootstrap the cluster
Just follow Get Started guide starting from the Bootstrap cluster section, to continue the installation.
Last modified 2024-09-06: Prepare release v0.14.1 (d4803a6)