Install MAAS

Follow the instructions below to download, configure and install MAAS.

Talk to our experts

We make MAAS amazing, and we help people run critical infrastructure at scale with it. Contact us for more information or to discuss your specific needs.

Contact us ›
  1. Setup your hardware

    You need:

    1. One small server for MAAS
    2. At least one server which can be managed with a BMC

    It is recommended to have the MAAS server provide DHCP and DNS on a network that the managed machines are connected to.

  2. Install Ubuntu Server

    Download Ubuntu Server 20.04 LTS by choosing the Manual install option and follow the step-by-step installation instructions on your MAAS server.

  3. Install MAAS

  4. Create admin user

    Create your admin credentials.

    Log in to the MAAS UI at http://<your.maas.ip>:5240/MAAS/

  5. Complete the first user configuration journey

    Follow the instructions on screen to complete the first installation of MAAS. We recommend using the default values unless your installation has different requirements.

    By the end of the journey you should have the following configured;

    • Region name (MAAS name)
    • Ubuntu archive, Ubuntu extra architectures
    • Ubuntu images
    • SSH keys (for currently logged in user)

    First user journey screenshot

  6. 6 Turn on DHCP

    Go to the “Subnets” tab, and select the VLAN for which you want to enable DHCP. From the “Take action” button select “Provide DHCP”.

    1. Set the Rack controller that will manage DHCP.
    2. Select the subnet where to create the DHCP Dynamic range on.
    3. Fill in the details for the dynamic range.

    VLAN details

  7. 7 Enlist and commission servers

    Now MAAS is ready to enlist and commission machines.

    1. Set all the servers to PXE boot
    2. Boot each machine once. You should see these machines appear in MAAS
    3. If your machines do not have a IPMI based BMC, proceed to edit them and enter their BMC details
    4. Select all the machines and “Commission” them using the “Take action” button
    5. When machines have a “Ready” status you can start deploying

    MAAS node listing

    Refer to the user manual to get a more detailed guide in how to get up and running with MAAS