How to get MAAS running

MAAS is relatively easy to install and configure. You can view the big picture or find specific operations in the permuted index.

Installation big picture view

  • Installation: Everything you need to know about installing and configuring MAAS, from either Debian packages or the snap.
  • Upgrade older versions: A dedicated page for upgrading from older versions of MAAS, including OS update requirements.
  • Troubleshooting: If you run into something odd, it might be that we’ve seen it before; try here first.

Installation permuted index

2.8 or lower to MAAS 2.9 How to upgrade from MAAS
2.8 or lower to MAAS 3.0 How to upgrade from
2.8 or lower to MAAS 3.1 How to upgrade from
2.8 or lower to MAAS 3.2 How to upgrade from
2.9 from packages How to do a fresh install of MAAS
2.9 or higher How to ugprade to MAAS 3.2 from MAAS
2.9 snap for a test or POC environment How to initialise MAAS
2.9 How to do a fresh snap install of MAAS
2.9 How to upgrade from MAAS 2.8 or lower to MAAS
2.9 How to upgrade from an earlier snap version to MAAS
2.9 to MAAS 3.0 How to ugprade from MAAS
2.9 user How to create a MAAS
3.0 from packages How to do a fresh install of MAAS
3.0 snap for a test or POC environment How to initialise MAAS
3.0 How to do a fresh snap install of MAAS
3.0 How to upgrade from 2.8 or lower to MAAS
3.0 How to ugprade from MAAS 2.9 to MAAS
3.0 How to upgrade from an earlier snap version to MAAS
3.0 to MAAS 3.1 How to ugprade from MAAS
3.0 user How to create a MAAS
3.1 from packages How to do a fresh install of MAAS
3.1 snap for a test or POC environment How to initialise MAAS
3.1 How to do a fresh snap install of MAAS
3.1 How to upgrade from 2.8 or lower to MAAS
3.1 How to ugprade from MAAS 3.0 to MAAS
3.1 How to upgrade from an earlier snap version to MAAS
3.1 user How to create a MAAS
3.2 from MAAS 2.9 or higher How to ugprade to MAAS
3.2 from packages How to do a fresh install of MAAS
3.2 snap for a test or POC environment How to initialise MAAS
3.2 How to do a fresh snap install of MAAS
3.2 How to upgrade from 2.8 or lower to MAAS
3.2 How to upgrade from an earlier snap version to MAAS
3.2 user How to create a MAAS
About network discovery
About SSH keys
About the MAAS URL
About the shared secret
Adding overlapping subnets in fabric can break deployments
additional MAAS initialisation options How to list
address Need to reconfigure server IP
administrator password Forgot MAAS
admin user How to set up SSH for the
a fresh install of MAAS 2.9 from packages How to do
a fresh install of MAAS 3.0 from packages How to do
a fresh install of MAAS 3.1 from packages How to do
a fresh install of MAAS 3.2 from packages How to do
a fresh snap install of MAAS 2.9 How to do
a fresh snap install of MAAS 3.0 How to do
a fresh snap install of MAAS 3.1 How to do
a fresh snap install of MAAS 3.2 How to do
after deployment Can’t login to machine
a MAAS 2.9 user How to create
a MAAS 3.0 user How to create
a MAAS 3.1 user How to create
a MAAS 3.2 user How to create
an earlier snap version to MAAS 2.9 How to upgrade from
an earlier snap version to MAAS 3.0 How to upgrade from
an earlier snap version to MAAS 3.1 How to upgrade from
an earlier snap version to MAAS 3.2 How to upgrade from
an incorrectly Possible Cause: Using
a production configuration Initialise MAAS for
a production environment Requirements for
a test environment Requirements for
a test or POC environment How to initialise MAAS 2.9 snap for
a test or POC environment How to initialise MAAS 3.0 snap for
a test or POC environment How to initialise MAAS 3.1 snap for
a test or POC environment How to initialise MAAS 3.2 snap for
Backdoor image login
boot Nodes fail to PXE
break deployments Adding overlapping subnets in fabric can
by django Subarchitecture error thrown
can break deployments Adding overlapping subnets in fabric
Can’t find MAAS web UI
Can’t login to machine after deployment
Can’t log in to node
Cause: DHCP conflict Possible
Cause: Network drivers Possible
Cause: Timing issues Possible
Cause: Using an incorrectly Possible
check system requirements for MAAS How to
check the status of MAAS services How to
CLI “File not found” when creating commissioning or node script with MAAS
cloud image Extract the
Command ‘packer’ not found
commissioning or node script with MAAS CLI “File not found” when creating
“Commissioning” Nodes hang on
Configuration
configuration Initialise MAAS for a production
configure MAAS How to
conflict Possible Cause: DHCP
create a MAAS 2.9 user How to
create a MAAS 3.0 user How to
create a MAAS 3.1 user How to
create a MAAS 3.2 user How to
create QEMU driver Failure to
creating commissioning or node script with MAAS CLI “File not found” when
creation problems Custom image
Custom image creation problems
custom image Use the
deployment fails Node
deployments Adding overlapping subnets in fabric can break
deployment Can’t login to machine after
DHCP conflict Possible Cause:
DHCP How to enable
discovery About network
django Subarchitecture error thrown by
DNS How to set upstream
do a fresh install of MAAS 2.9 from packages How to
do a fresh install of MAAS 3.0 from packages How to
do a fresh install of MAAS 3.1 from packages How to
do a fresh install of MAAS 3.2 from packages How to
do a fresh snap install of MAAS 2.9 How to
do a fresh snap install of MAAS 3.0 How to
do a fresh snap install of MAAS 3.1 How to
do a fresh snap install of MAAS 3.2 How to
drivers Possible Cause: Network
driver Failure to create QEMU
earlier snap version to MAAS 2.9 How to upgrade from an
earlier snap version to MAAS 3.0 How to upgrade from an
earlier snap version to MAAS 3.1 How to upgrade from an
earlier snap version to MAAS 3.2 How to upgrade from an
enable DHCP How to
environment How to initialise MAAS 2.9 snap for a test or POC
environment How to initialise MAAS 3.0 snap for a test or POC
environment How to initialise MAAS 3.1 snap for a test or POC
environment How to initialise MAAS 3.2 snap for a test or POC
environment Requirements for a production
environment Requirements for a test
error thrown by django Subarchitecture
Extract the cloud image
fabric can break deployments Adding overlapping subnets in
fails Node deployment
fail to PXE boot Nodes
failures Machine life-cycle
Failure to create QEMU driver
“File not found” when creating commissioning or node script with MAAS CLI
find MAAS web UI Can’t
for a production configuration Initialise MAAS
for a production environment Requirements
for a test environment Requirements
for a test or POC environment How to initialise MAAS 2.9 snap
for a test or POC environment How to initialise MAAS 3.0 snap
for a test or POC environment How to initialise MAAS 3.1 snap
for a test or POC environment How to initialise MAAS 3.2 snap
Forgot MAAS administrator password
for MAAS How to check system requirements
for the admin user How to set up SSH
found Command ‘packer’ not
found" when creating commissioning or node script with MAAS CLI "File not
fresh install of MAAS 2.9 from packages How to do a
fresh install of MAAS 3.0 from packages How to do a
fresh install of MAAS 3.1 from packages How to do a
fresh install of MAAS 3.2 from packages How to do a
fresh snap install of MAAS 2.9 How to do a
fresh snap install of MAAS 3.0 How to do a
fresh snap install of MAAS 3.1 How to do a
fresh snap install of MAAS 3.2 How to do a
from 2.8 or lower to MAAS 3.0 How to upgrade
from 2.8 or lower to MAAS 3.1 How to upgrade
from 2.8 or lower to MAAS 3.2 How to upgrade
from an earlier snap version to MAAS 2.9 How to upgrade
from an earlier snap version to MAAS 3.0 How to upgrade
from an earlier snap version to MAAS 3.1 How to upgrade
from an earlier snap version to MAAS 3.2 How to upgrade
from MAAS 2.8 or lower to MAAS 2.9 How to upgrade
from MAAS 2.9 or higher How to ugprade to MAAS 3.2
from MAAS 2.9 to MAAS 3.0 How to ugprade
from MAAS 3.0 to MAAS 3.1 How to ugprade
from packages How to do a fresh install of MAAS 2.9
from packages How to do a fresh install of MAAS 3.0
from packages How to do a fresh install of MAAS 3.1
from packages How to do a fresh install of MAAS 3.2
from scratch Setting up PostgreSQL
Generate password hash
hang on “Commissioning” Nodes
hash Generate password
higher How to ugprade to MAAS 3.2 from MAAS 2.9 or
How to check system requirements for MAAS
How to check the status of MAAS services
How to configure MAAS
How to create a MAAS 2.9 user
How to create a MAAS 3.0 user
How to create a MAAS 3.1 user
How to create a MAAS 3.2 user
How to do a fresh install of MAAS 2.9 from packages
How to do a fresh install of MAAS 3.0 from packages
How to do a fresh install of MAAS 3.1 from packages
How to do a fresh install of MAAS 3.2 from packages
How to do a fresh snap install of MAAS 2.9
How to do a fresh snap install of MAAS 3.0
How to do a fresh snap install of MAAS 3.1
How to do a fresh snap install of MAAS 3.2
How to enable DHCP
How to import images
How to initialise MAAS 2.9 snap for a test or POC environment
How to initialise MAAS 3.0 snap for a test or POC environment
How to initialise MAAS 3.1 snap for a test or POC environment
How to initialise MAAS 3.2 snap for a test or POC environment
How to install MAAS
How to list additional MAAS initialisation options
How to re-initialise MAAS
How to set up SSH for the admin user
How to set upstream DNS
How to ugprade from MAAS 2.9 to MAAS 3.0
How to ugprade from MAAS 3.0 to MAAS 3.1
How to ugprade to MAAS 3.2 from MAAS 2.9 or higher
How to upgrade from 2.8 or lower to MAAS 3.0
How to upgrade from 2.8 or lower to MAAS 3.1
How to upgrade from 2.8 or lower to MAAS 3.2
How to upgrade from an earlier snap version to MAAS 2.9
How to upgrade from an earlier snap version to MAAS 3.0
How to upgrade from an earlier snap version to MAAS 3.1
How to upgrade from an earlier snap version to MAAS 3.2
How to upgrade from MAAS 2.8 or lower to MAAS 2.9
image creation problems Custom
image login Backdoor
images How to import
image Extract the cloud
image Rebuild SquashFS
image Use the custom
import images How to
incorrectly Possible Cause: Using an
in fabric can break deployments Adding overlapping subnets
initialisation modes reference MAAS
initialisation options How to list additional MAAS
initialise MAAS 2.9 snap for a test or POC environment How to
initialise MAAS 3.0 snap for a test or POC environment How to
initialise MAAS 3.1 snap for a test or POC environment How to
initialise MAAS 3.2 snap for a test or POC environment How to
Initialise MAAS for a production configuration
install MAAS How to
install of MAAS 2.9 from packages How to do a fresh
install of MAAS 2.9 How to do a fresh snap
install of MAAS 3.0 from packages How to do a fresh
install of MAAS 3.0 How to do a fresh snap
install of MAAS 3.1 from packages How to do a fresh
install of MAAS 3.1 How to do a fresh snap
install of MAAS 3.2 from packages How to do a fresh
install of MAAS 3.2 How to do a fresh snap
in to node Can’t log
IP address Need to reconfigure server
issues Miscellaneous
issues Networking
issues Possible Cause: Timing
keys About SSH
life-cycle failures Machine
list additional MAAS initialisation options How to
login Backdoor image
login to machine after deployment Can’t
log in to node Can’t
lower to MAAS 2.9 How to upgrade from MAAS 2.8 or
lower to MAAS 3.0 How to upgrade from 2.8 or
lower to MAAS 3.1 How to upgrade from 2.8 or
lower to MAAS 3.2 How to upgrade from 2.8 or
MAAS 2.8 or lower to MAAS 2.9 How to upgrade from
MAAS 2.9 from packages How to do a fresh install of
MAAS 2.9 or higher How to ugprade to MAAS 3.2 from
MAAS 2.9 snap for a test or POC environment How to initialise
MAAS 2.9 How to do a fresh snap install of
MAAS 2.9 How to upgrade from MAAS 2.8 or lower to
MAAS 2.9 How to upgrade from an earlier snap version to
MAAS 2.9 to MAAS 3.0 How to ugprade from
MAAS 2.9 user How to create a
MAAS 3.0 from packages How to do a fresh install of
MAAS 3.0 snap for a test or POC environment How to initialise
MAAS 3.0 How to do a fresh snap install of
MAAS 3.0 How to upgrade from 2.8 or lower to
MAAS 3.0 How to ugprade from MAAS 2.9 to
MAAS 3.0 How to upgrade from an earlier snap version to
MAAS 3.0 to MAAS 3.1 How to ugprade from
MAAS 3.0 user How to create a
MAAS 3.1 from packages How to do a fresh install of
MAAS 3.1 snap for a test or POC environment How to initialise
MAAS 3.1 How to do a fresh snap install of
MAAS 3.1 How to upgrade from 2.8 or lower to
MAAS 3.1 How to ugprade from MAAS 3.0 to
MAAS 3.1 How to upgrade from an earlier snap version to
MAAS 3.1 user How to create a
MAAS 3.2 from MAAS 2.9 or higher How to ugprade to
MAAS 3.2 from packages How to do a fresh install of
MAAS 3.2 snap for a test or POC environment How to initialise
MAAS 3.2 How to do a fresh snap install of
MAAS 3.2 How to upgrade from 2.8 or lower to
MAAS 3.2 How to upgrade from an earlier snap version to
MAAS 3.2 user How to create a
MAAS administrator password Forgot
MAAS CLI “File not found” when creating commissioning or node script with
MAAS for a production configuration Initialise
MAAS initialisation modes reference
MAAS initialisation options How to list additional
MAAS services How to check the status of
MAAS How to check system requirements for
MAAS How to configure
MAAS How to install
MAAS How to re-initialise
MAAS URL About the
MAAS web UI Can’t find
machine after deployment Can’t login to
Machine life-cycle failures
make target …OVMF_VARS.fd No rule to
Miscellaneous issues
modes reference MAAS initialisation
Need to reconfigure server IP address
network discovery About
Network drivers Possible Cause:
Networking issues
Node deployment fails
node script with MAAS CLI “File not found” when creating commissioning or
Nodes fail to PXE boot
Nodes hang on “Commissioning”
node Can’t log in to
No rule to make target …OVMF_VARS.fd
not found Command ‘packer’
not found" when creating commissioning or node script with MAAS CLI "File
of MAAS 2.9 from packages How to do a fresh install
of MAAS 2.9 How to do a fresh snap install
of MAAS 3.0 from packages How to do a fresh install
of MAAS 3.0 How to do a fresh snap install
of MAAS 3.1 from packages How to do a fresh install
of MAAS 3.1 How to do a fresh snap install
of MAAS 3.2 from packages How to do a fresh install
of MAAS 3.2 How to do a fresh snap install
of MAAS services How to check the status
on “Commissioning” Nodes hang
options How to list additional MAAS initialisation
or higher How to ugprade to MAAS 3.2 from MAAS 2.9
or lower to MAAS 2.9 How to upgrade from MAAS 2.8
or lower to MAAS 3.0 How to upgrade from 2.8
or lower to MAAS 3.1 How to upgrade from 2.8
or lower to MAAS 3.2 How to upgrade from 2.8
or node script with MAAS CLI “File not found” when creating commissioning
or POC environment How to initialise MAAS 2.9 snap for a test
or POC environment How to initialise MAAS 3.0 snap for a test
or POC environment How to initialise MAAS 3.1 snap for a test
or POC environment How to initialise MAAS 3.2 snap for a test
overlapping subnets in fabric can break deployments Adding
…OVMF_VARS.fd No rule to make target
packages How to do a fresh install of MAAS 2.9 from
packages How to do a fresh install of MAAS 3.0 from
packages How to do a fresh install of MAAS 3.1 from
packages How to do a fresh install of MAAS 3.2 from
‘packer’ not found Command
password hash Generate
password Forgot MAAS administrator
POC environment How to initialise MAAS 2.9 snap for a test or
POC environment How to initialise MAAS 3.0 snap for a test or
POC environment How to initialise MAAS 3.1 snap for a test or
POC environment How to initialise MAAS 3.2 snap for a test or
Possible Cause: DHCP conflict
Possible Cause: Network drivers
Possible Cause: Timing issues
Possible Cause: Using an incorrectly
PostgreSQL from scratch Setting up
problems Custom image creation
production configuration Initialise MAAS for a
production environment Requirements for a
PXE boot Nodes fail to
QEMU driver Failure to create
Rebuild SquashFS image
reconfigure server IP address Need to
reference MAAS initialisation modes
re-initialise MAAS How to
Requirements for a production environment
Requirements for a test environment
requirements for MAAS How to check system
rule to make target …OVMF_VARS.fd No
scratch Setting up PostgreSQL from
script with MAAS CLI “File not found” when creating commissioning or node
secret About the shared
server IP address Need to reconfigure
services How to check the status of MAAS
Setting up PostgreSQL from scratch
set up SSH for the admin user How to
set upstream DNS How to
shared secret About the
snap for a test or POC environment How to initialise MAAS 2.9
snap for a test or POC environment How to initialise MAAS 3.0
snap for a test or POC environment How to initialise MAAS 3.1
snap for a test or POC environment How to initialise MAAS 3.2
snap install of MAAS 2.9 How to do a fresh
snap install of MAAS 3.0 How to do a fresh
snap install of MAAS 3.1 How to do a fresh
snap install of MAAS 3.2 How to do a fresh
snap version to MAAS 2.9 How to upgrade from an earlier
snap version to MAAS 3.0 How to upgrade from an earlier
snap version to MAAS 3.1 How to upgrade from an earlier
snap version to MAAS 3.2 How to upgrade from an earlier
SquashFS image Rebuild
SSH for the admin user How to set up
SSH keys About
status of MAAS services How to check the
Subarchitecture error thrown by django
subnets in fabric can break deployments Adding overlapping
system requirements for MAAS How to check
target …OVMF_VARS.fd No rule to make
test environment Requirements for a
test or POC environment How to initialise MAAS 2.9 snap for a
test or POC environment How to initialise MAAS 3.0 snap for a
test or POC environment How to initialise MAAS 3.1 snap for a
test or POC environment How to initialise MAAS 3.2 snap for a
the admin user How to set up SSH for
the cloud image Extract
the custom image Use
the MAAS URL About
the shared secret About
the status of MAAS services How to check
thrown by django Subarchitecture error
Timing issues Possible Cause:
to check system requirements for MAAS How
to check the status of MAAS services How
to configure MAAS How
to create a MAAS 2.9 user How
to create a MAAS 3.0 user How
to create a MAAS 3.1 user How
to create a MAAS 3.2 user How
to create QEMU driver Failure
to do a fresh install of MAAS 2.9 from packages How
to do a fresh install of MAAS 3.0 from packages How
to do a fresh install of MAAS 3.1 from packages How
to do a fresh install of MAAS 3.2 from packages How
to do a fresh snap install of MAAS 2.9 How
to do a fresh snap install of MAAS 3.0 How
to do a fresh snap install of MAAS 3.1 How
to do a fresh snap install of MAAS 3.2 How
to enable DHCP How
to import images How
to initialise MAAS 2.9 snap for a test or POC environment How
to initialise MAAS 3.0 snap for a test or POC environment How
to initialise MAAS 3.1 snap for a test or POC environment How
to initialise MAAS 3.2 snap for a test or POC environment How
to install MAAS How
to list additional MAAS initialisation options How
to MAAS 2.9 How to upgrade from MAAS 2.8 or lower
to MAAS 2.9 How to upgrade from an earlier snap version
to MAAS 3.0 How to upgrade from 2.8 or lower
to MAAS 3.0 How to ugprade from MAAS 2.9
to MAAS 3.0 How to upgrade from an earlier snap version
to MAAS 3.1 How to upgrade from 2.8 or lower
to MAAS 3.1 How to ugprade from MAAS 3.0
to MAAS 3.1 How to upgrade from an earlier snap version
to MAAS 3.2 from MAAS 2.9 or higher How to ugprade
to MAAS 3.2 How to upgrade from 2.8 or lower
to MAAS 3.2 How to upgrade from an earlier snap version
to machine after deployment Can’t login
to make target …OVMF_VARS.fd No rule
to node Can’t log in
to PXE boot Nodes fail
to reconfigure server IP address Need
to re-initialise MAAS How
to set up SSH for the admin user How
to set upstream DNS How
to ugprade from MAAS 2.9 to MAAS 3.0 How
to ugprade from MAAS 3.0 to MAAS 3.1 How
to ugprade to MAAS 3.2 from MAAS 2.9 or higher How
to upgrade from 2.8 or lower to MAAS 3.0 How
to upgrade from 2.8 or lower to MAAS 3.1 How
to upgrade from 2.8 or lower to MAAS 3.2 How
to upgrade from an earlier snap version to MAAS 2.9 How
to upgrade from an earlier snap version to MAAS 3.0 How
to upgrade from an earlier snap version to MAAS 3.1 How
to upgrade from an earlier snap version to MAAS 3.2 How
to upgrade from MAAS 2.8 or lower to MAAS 2.9 How
ugprade from MAAS 2.9 to MAAS 3.0 How to
ugprade from MAAS 3.0 to MAAS 3.1 How to
ugprade to MAAS 3.2 from MAAS 2.9 or higher How to
UI Can’t find MAAS web
upgrade from 2.8 or lower to MAAS 3.0 How to
upgrade from 2.8 or lower to MAAS 3.1 How to
upgrade from 2.8 or lower to MAAS 3.2 How to
upgrade from an earlier snap version to MAAS 2.9 How to
upgrade from an earlier snap version to MAAS 3.0 How to
upgrade from an earlier snap version to MAAS 3.1 How to
upgrade from an earlier snap version to MAAS 3.2 How to
upgrade from MAAS 2.8 or lower to MAAS 2.9 How to
up PostgreSQL from scratch Setting
up SSH for the admin user How to set
upstream DNS How to set
URL About the MAAS
user How to create a MAAS 2.9
user How to create a MAAS 3.0
user How to create a MAAS 3.1
user How to create a MAAS 3.2
user How to set up SSH for the admin
Use the custom image
Using an incorrectly Possible Cause:
version to MAAS 2.9 How to upgrade from an earlier snap
version to MAAS 3.0 How to upgrade from an earlier snap
version to MAAS 3.1 How to upgrade from an earlier snap
version to MAAS 3.2 How to upgrade from an earlier snap
web UI Can’t find MAAS
when creating commissioning or node script with MAAS CLI “File not found”
with MAAS CLI “File not found” when creating commissioning or node script

Last updated 30 days ago.