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. 1 Setup your hardware

    You need one small server for MAAS and 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 the managed machines are connected to.

  2. 2 Install Ubuntu Server

    Download Ubuntu Server 16.04 LTS and follow the step-by-step installation instructions on your MAAS server.

  3. 3 Install MAAS

  4. 4 Create admin user

    Create your admin credentials by typing.

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

  5. 5 Complete the first user configuration journey

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

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

    • Region 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, and on 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