Install from Packages

There are three packages to consider when installing MAAS:

  • maas-region-controller - region API server, database, DNS, HTTP proxy, and web UI
  • maas-rack-controller - rack controller and DHCP
  • maas - a metapackage that installs both the above packages to provide a complete MAAS environment

Each of the above packages has its own dependencies. That is, each will bring in other MAAS packages not listed above. The full list of MAAS packages can be obtained with the command:

apt-cache search maas

The 'maas' metapackage is the recommended way to install MAAS. See the Introduction for more detail on colocating all services on a single host.

High availability with MAAS involves installing multiple region controllers and/or multiple rack controllers. See MAAS HA.

Package repositories

While MAAS is available in the normal Ubuntu archives, the available packages may be lagging behind non-archive, but still stable, versions. To install a newer stable version the following PPA can be used:

Development releases (not meant for production) are available here:

For example, to add the 'stable' PPA, type:

sudo apt-add-repository -yu ppa:maas/stable

Installation scenarios

The recommended way to set up an initial MAAS environment is to put everything on one machine:

sudo apt install maas

For a more distributed environment, the region controller can be placed on one machine:

sudo apt install maas-region-controller

and the rack controller (see Rack controller for details) on another:

sudo apt install maas-rack-controller
sudo maas-rack register