Accessing MAAS

Access the web UI MAAS Dashboard

As the preferred way to manage MAAS, the web UI is where users spend much of their time. This page explains how to access the web UI for the first time and draws attention to the first iteration of the MAAS Dashboard.

Access the web UI

Unless you install MAAS from a snap or the Ubuntu Server ISO, you will need to create a MAAS administrator user to access the web UI:

sudo maas createadmin --username=$PROFILE --email=$EMAIL_ADDRESS

For example:

sudo maas createadmin --username=admin

The username can be anything. You will also be prompted to supply a password for the user. The command option --password=$PASSWORD can be used to specify one but, depending on your environment, this may pose a security risk.

At this time, MAAS does not make use of the email address. However, it may do so in the future.

You can now login here:


where $API_HOST is the hostname or IP address of the region API server.

web UI login

The initial administrator will be shown the MAAS Dashboard after they log in for the first time. Here, there will be the option of embarking on a configuration journey to get MAAS up and running quickly. This is explained in Configuration journey.

Once logged in, an administrator can create regular users as well as additional administrators. See User Accounts for this.

See MAAS CLI for logging in via the CLI and working with the CLI.

MAAS Dashboard

The Dashboard will be a central hub for the user to branch out to other parts of the web UI to perform certain operations. For now, it points to the main pages of the web UI such as Machines, Devices, Controllers, Pods, Images, DNS, AZs, Subnets and Settings. It also logs the results of Device discovery.

The Dashboard is available by clicking the MAAS icon (top-left corner). Its URL is:


This could use some clarification.

Thanks @wcooleytw, should be fixed now.

1 Like