Developer Docs

Ubuntu 18.04 Virtual Machine Setup

To setup a local server operating system from scratch, you will need to download the Oracle VM VirtualBox Manager and install Ubuntu.

Approximate setup time is 30-40 minutes.

  1. Download and install the latest copy of Oracle VM VirtualBox for your host OS.
  2. Download a copy of Ubuntu Server v18.04.3 LTS 64-bit (Bionic Beaver)
  3. Start VirtualBox and create a new Virtual Machine
    1. Click the New Button.

    2. Fill out the name and operating system.

    3. Set the memory to 2048 MB. If you find this is too slow, you can change it at any time while the VM is shutdown.

    4. Create a virtual hard drive now.

    5. Select the VDI (VirtualBox Disk Image) as your hard drive file type.

    6. Set storage on physical hard drive to dynamically allocated.

    7. Change the name to include a date like Ubuntu 18.04 VM 20190129 and the size to be at least 20GB. The more the better! Changing this later is not an easy task.

    8. Click the “Create” button to finish the initial configuration.

  4. Start the virtual machine.

  5. When the pop-up dialog appears, select the Ubuntu 18.04 iso you downloaded earlier.

  6. Select your language.

  7. Select your keyboard config.

  8. Press Enter to select the default network connection configuration.

  9. Press Enter to skip adding a proxy

  10. Press Enter to select the default Mirror address.

  11. Ensure that “Use an Entire Disk” is selected and press Enter.

  12. Press Enter to continue when presented with the virtual disk image we created earlier.

  13. We are now presented with the hard disk partition schema of the new virtual machine. Ensure that “Done” is highlighted and press Enter to continue.

  14. Select and highlight “Continue” and press Enter to confirm the hard disk config.

  15. While Ubuntu 18.04 is installing, you must enter some user information. This creates the default user. Enter the following information for your Codebots app:

    • Your name: Joe Bloggs
    • Your server’s name: springbot
    • Pick a username: user
    • Choose a password: cb
    • Confirm your password: cb
    • Click “Done”
  16. Install OpenSSH now, so that you can SSH into your server for future steps. Press the Space Bar to select the “Install OpenSSH server” option, tab to “Done” and press Enter.

  17. You do not need to install any servers at this stage. Tab to Done and press Enter.

  18. Once the installation completes, select “Reboot Now” and press Enter.

    If you are on a laptop using battery power, the update may fail. Please ensure you are plugged into a power source

  19. You will be prompted to remove the installation media before rebooting. Simply press Enter to continue.

  20. Login to the server using the credentials you set above:

  21. Update the OS. Type in the following commands one at a time, press Enter and wait for each command to stop running. The command prompt will become available again after each process is finished.

    sudo rm -rf /var/lib/apt/lists/*
    sudo apt-get update
    sudo apt-get upgrade
  22. Install the VirtualBox Guest Additions.

    1. The CD icon at the bottom of the Ubuntu VirtualBox window should be greyed out, indicating that there is no CD in your virtual machine.

    2. In the VirtualBox Guest window, click Devices > Insert Guest Additions CD Image.

    3. The CD icon in the bottom tray of the Ubuntu VirtualBox window should now be filled in.

    4. Now install the additions in your VM. Type the following into the command prompt and wait for the prompt to become available after each process is finished.

       sudo apt-get install make gcc
       sudo mount /dev/cdrom /mnt

      You will see a warning that it is read only. This is fine. Continue

       cd /mnt
       sudo ./
    5. Shutdown your virtual machine so that you can configure a virtual network adaptor. Running this command will close the Ubuntu VirtualBox window, but your main VirtualBox window will still be open. Type the following and press enter.

       sudo shutdown now
  23. In your main VirtualBox window, add a “Host Only” Adapter so you can SSH to the server

    1. Configure a Host-only Network via the VirtualBox manager (File > Host Network Manager>)
    2. Click “Create”


      On Windows you may get prompted by User Access Control to confirm that this application can make changes to your system. Click “Yes”

    3. Make sure the new VirtualBox Host Adaptor is selected and click “Properties”. Update the IPv4 Address to and ensure “DHCP Server” is checked.


      On Windows you may get prompted by User Access Control to confirm that this application can make changes to your system. Click “Yes”

  24. Configure the new adaptor. Ensure the VM is powered off, then Right Click the Virtual Machine name to access Settings.

  25. In the VM settings, navigate to Network > Adapter 2 > Enable. Set “Attached To” to “Host-only Adapter”

  26. Configure the Virtual machines network settings. Start the VM and edit the network configuration.

    1. Edit the netplan yaml file. Type the below and press Enter.

       sudo nano /etc/netplan/50-cloud-init.yaml
    2. Replace the contents of the file to match the screenshot below. You cannot use Tabs in this file. Use four Spaces for each instead.


      (If false doesn’t work, use no instead).

    3. Hit Ctrl + X to exit, type Y to save, then hit Enter to save the file and exit the editor
    4. Apply the netplan and restart the VM. Type the below and press Enter after each line.

       sudo netplan apply
       sudo reboot
  27. Ensure new IP address is set. You should see enp0s8 with the IP address assigned as above and it should be UP and RUNNING. Run the following in your virtual machine to check this is working:
    ifconfig -a
  28. Check the virtual machine is reachable from your host machine

    1. From the command line of your host machine (i.e. for Windows, press the “Windows” key, type cmd and select the “Command Prompt” option. When the Command Prompt window opens, type the following and press Enter:
    2. Ensure you get a reply


You now have the ability to SSH into your virtual machine. It is recommended to use a tool like PuTTY or Terminal to connect to remotely connect to your virtual machine. Doing so will give you the ability to copy and paste scripts from the articles into your virtual machine. Instructions for this process can be found in Connect to your server.

To install the required dependencies for a SpringBot application, please complete the Setting Up Your Development Environment: Linux lesson.

Was this article helpful?

Thanks for your feedback!

If you would like to tell us more, please click on the link below to send us a message with more details.







On this page

New to Codebots?

We know our software can be complicated, so we are always happy to have a chat if you have any questions.