Install from Packages
This page covers the use of deb/APT packages to install MAAS, which is the recommended method. It allows for control over where specific components are placed, when upgrades are applied, and where packages are installed from.
MAAS also offers the following installation options:
- Snap. Benefits from autonomous upgrades and direct access to beta and developmental versions
- Ubuntu Server ISO. Conveniently install MAAS as you provision a new server
Additionally, you may want to consider an installation within LXD containers. This allows MAAS nodes to also run as local containers and is ideal for testing and experimenting with MAAS.
See MAAS HA for more information about installing MAAS via Snaps in high-availability environments.
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.
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
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