Web UI

The MAAS web UI is where users will spend much of their time. It is the preferred way to manage MAAS. This page will explain how to access the web UI for the first time and also draw attention to the first iteration of the MAAS Dashboard.

Access the web UI

Unless MAAS was installed from the Ubuntu Server ISO (see Install from ISO), you'll need to create a user in order to access the web UI. This initial user is a MAAS administrator:

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

For example:

sudo maas createadmin --username=admin --email=admin@example.com

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.

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

You can now log in here:


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

web UI login

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.

© 2018 Canonical Ltd. Ubuntu and Canonical are registered trademarks of Canonical Ltd.