---

:.: fart-init

fart-init it's a little script that tries to get cloud-init files (meta-data, user-data and network-data) to configure the server with it, after that, it will clean up the server and itself. The idea is to create a new and clean server from a template proxmox/qemu with a basic and minimalistic configuration.

:. What can it do?

fart-init can do:

- set a main user and ssh-keys
- set a root password
- set the network (dhcp or static)
- install a list of packages (soon)

what it can't do:

- it won't resize or change partitions on your VM
- configure any service on base system (you should do this with something else)

what it will do by default for you:

- enable unwind(8) as resolver
- disable sndiod(8) since I asume this is a server
- clean up all packages installed
- delete all residual files in the server that are not standard
- delete the user given as main and created it again

:. Setup

I based fart-init on cloud-init's files, so for it, you will need 3 files meta-data, user-data and network-data, each one of them has the information that it will be extract by fart-init to set up the server.

You can give these 3 files in 2 different ways to fart-init:

- Over cloud-init on Proxmox (VM -> Cloud-init -> Edit -> Regenerate)
- Over a webserver reacheable from the VM

#######################################################################
Proxmox is a linux server and their password hashing is different from the one we use in OpenBSD, so the password given over Proxmox for the user won't work, use the ssh-key instead and set up a root password inside fart-init, or just use the default one for root which is "fart-init"
#######################################################################

If you will serve the files by Proxmox just fill the "cloud-init" information as you want and regenerate it, that should be enough, if you want to serve the files over a webserver, they should look like this:

$ cat user-data
#cloud-config
hostname: fart-init
username: gonzalo
password: puffy01
ssh-key: "ssh-ed25519 AAAAC3NzaFsTghZaSAAIPxVebz+gL0DqbsikzlMBA0SM059VkOmEGly3b24SnNH"
chpasswd:
  expire: False

$ cat meta-data
instance-id: 999/fart-init
local-hostname: fart-init

$ cat network-data
version: 1
config:
    - type: physical
      name: eth0
      mac_address: '16:70:0d:8e:dd:a4'
      subnets:
      - type: dhcp4
    - type: nameserver
      address:
      - '9.9.9.9'
      search:
      - 'fart.home'

$ cat network-data
version: 1
config:
    - type: physical
      name: eth0
      mac_address: '16:70:0d:8e:dd:a4'
      subnets:
      - type: static
        address: '192.168.0.211'
        netmask: '255.255.255.0'
        gateway: '192.168.0.1'
    - type: nameserver
      address:
      - '192.168.0.123'
      search:
      - 'fart.home'

As I said you can serve these files with a webserver (httpd(8)) or just using python for example like:

proxmox:~/files# ls -al
total 20
drwxr-xr-x 2 root root 4096 May 22 19:12 .
drwx------ 5 root root 4096 May 22 15:54 ..
-rw-r--r-- 1 root root   53 May 22 15:58 meta-data
-rw-r--r-- 1 root root  345 May 22 18:54 network-config
-rw-r--r-- 1 root root  186 May 22 19:12 user-data
proxmox:~/files# python3 -m http.server --directory .
Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...

Adjust the line FART_SRV="10.0.2.2:8000" inside fart-init to your needs and be sure the port is open on your firewall.

:. How to use it?

After created your OpenBSD template, you need to download fart-init and give it permissions, something like this (assuming your proxmox or virtual network is 10.0.2.0/24):

vm_template# cd /usr/local/sbin/
vm_template# ftp -V http://10.0.2.2:8000/fart-init
vm_template# chmod 755 fart-init
vm_template# echo '/usr/local/sbin/fart-init 2>&1 | tee /var/log/fart-init.log' > /etc/rc.local

And that is pretty much of it, keep in mind this is a very early version of it and it could be fail, I ran it several times on my setup without issues but this could change in yours.

During the first booting process you will see something like this:

And on the second boot:

Have fun!

---