Installing Debian 12 to VxBuild

Create Debian 12 USB

To install Debian 12 on the build machine (VxBuild), you will need to download the latest Debian 12 amd64 installer file here: Latest Debian Release

You should use a blank USB for this install drive. The process described below will wipe any existing content.

  1. To create a USB install drive with the downloaded iso file:

  2. Ensure the USB is available to the system. By default, it tries to attach as the /dev/sda device. An easy way to verify this is via the following command:

lsblk /dev/disk/by-id/usb*part* --noheadings --output PATH
  1. If the USB is not attached as the /dev/sda device, that’s ok. Simply replace “/dev/sda” with the device your USB did attach to.

  • NOTE: The command below should not include any number as part of the device path. As an example, if the above command returns “/dev/sda1”, you must use “/dev/sda” as the path in the next command.

  1. Now that you know the correct device path, you can create the USB install drive via the following command:

dd if=/path/to/debian-12.2.0-amd64-netinst.iso of=/dev/sda bs=4M && sync
  • NOTE: At the time of this writing, the latest stable release is 12.2. Please update to the appropriate filename if you use a newer version.)

  1. Once the above command completes, you can safely remove the USB install drive from your system.

Installing to VxBuild

  1. Before turning the VxBuild system on, insert the USB install drive created in the previous step.

  2. Boot the system from the USB install drive. (After powering the build machine on, begin pressing F12 until it enters the Boot Menu)

  3. You will be presented with the following screen:

  1. Select Graphical Install and press Enter

  1. Select your preferred language and click Continue.

  1. Select your location and click Continue.

  1. Select your keyboard layout and click Continue.

  1. Select your network device (may differ from screenshot) and click Continue.

  2. If using a wireless connection, follow the next steps. If using a wired connection, it will configure automatically.

  1. Select your network device (may differ from screenshot) and click Continue.

  1. Select WPA/WPA2 PSK and click Continue.

  1. Enter your wireless network password and click Continue.

  1. Enter “VxBuild” for the hostname and click Continue.

  1. Leave the domain name blank and click Continue.

  1. Set the root user password and click Continue.

  1. Enter “Vx” for the full name for the new user and click Continue.

  1. Enter “vx” as the username and click Continue.

  1. Enter a password for the “vx” user and click Continue.

  1. Select your timezone and click Continue.

  1. Select “Guided - use entire disk” and click Continue.

  1. Select the “/dev/nvme0n1” disk and click Continue.

  1. Select “All files in one partition” and click Continue.

  1. Select “Finish partitioning and write changes to disk” and click Continue.

  1. Select “Yes” and click Continue.

  2. The base OS installation will now begin. During the installation you will be asked to answer questions related to package management.

  1. Select “United States” and click Continue.

  2. Select “deb.debian.org” and click Continue.

  3. Leave the proxy information blank and click Continue.

  4. The installation process will continue automatically. You will be asked to configure “popularity-contest”.

  5. Select “No” and click Continue.

  6. Select the options as shown above and click Continue.

  7. The installation process will continue. Once it completes, you will be presented with a final screen confirming it was successful.

  8. Remove the USB drive and Click Continue.

  9. The system will reboot and automatically start Debian 12

  10. Log in with the “vx” user and password you created during the installation process.

  11. Several basic configuration prompts will be displayed.

  12. Select Next.

  13. Select your keyboard preference and click Next.

  14. Turn off Location Services and click Next.

  15. Do not configure any Online Accounts. Select Skip.

  16. Click the “Start Using Debian GNU/Linux” button. The dialog will be closed.

Grant sudo privileges

The “vx” user needs to be granted sudo privileges related to configuring and initializing the build environment tools. To do this, open a terminal window. (TODO: terminal instructions)

  1. The “vx” user needs to be granted sudo privileges related to configuring and initializing the build environment tools. To do this, open a terminal window. (TODO: terminal instructions)

  2. As the “vx” user, you will temporarily log in to the “root” account.

su -
<enter root user password>
  1. You will see your terminal window prompt change to “root@VxBuild”. To grant the “vx” user sudo privileges, run the following command as root.

echo "vx ALL=NOPASSWD: ALL" > /etc/sudoers.d/vx
exit
  1. You will see your terminal window prompt change to “vx@VxBuild”. You are now the “vx” user instead of the “root” user. To confirm sudo privileges, run the following command:

sudo whoami
  1. The command should return “root”. This confirms sudo privileges have been granted correctly.

Last updated