The idiots guide to setting up a Freeside machine

Setting up a Machine

  • Download a Fedora image from Download Fedora Workstation
  • Burn to a USB follow the instructions from This page has moved
  • Boot from USB by pressing F10 on boot up and selecting your usb device
  • Once booted in to Fedora live you should be greeted with an option to install fedora to hard drive.

Select UK Language and click continue

You will then see a screen like this, select “installation destination”

Select the hard drive to install Fedora to.

If the machine previously had an OS on it then we will have to reclaim space, selected automatic and “Make aditional space avaliable”.

Click “delete all” on the bottom right and then “reclaim space”

Next go to “Network and Host Name”. Set the domain to the format fs-desktop-03.freeside.co.uk replacing 03 with an incremental number based off the other machines.

Click done and then set a root password, We will not need to create a user account.

Once completed, restart the machine and remove the USB. You should be greeted with a Fresh install of Fedora.

Now you need to go to a tty using Ctrl+Alt+F2 and login as root.

Next Steps

After this, it is necessary to provision the machine onto the network so as to allow users to log on.

Before you continue, you should ensure that MAC address randomisation is disabled: How to disable MAC address randomisation on Fedora 31

This is important because the department need the MAC address to be actually sent when grabbing an IP address via DHCP, as they statically assign us IP addresses based on the MAC address.

The first step to this is to configure the free-ipa client; instructions on this can be found at FreeIPA - Identity Management System.
Once that’s done, you’ll likely run into mounting issues; this was previously solved using sudo setsebool -P use_nfs_home_dirs=on, so try this.

Following this, you need to setup fabric. The readme for GitHub - FreesideHull/Freeside-Fabfiles: Fabfile for Freeside gives details on this.

1 Like

The 2 tasks that need performing once Fedora is installed are setting up LDAP login via the FreeIPA server, and installing Fabric and connecting it to our GitHub repository.

@Epictek has written a guide on how to setup LDAP authentication here: FreeIPA - Identity Management System

Installing Fabric couldn’t be easier. Our repository README contains everything you need to know there.