MAAS documentation
MAAS stands for Metal as a Service. It lets you treat physical servers like virtual machines in the cloud. MAAS turns your bare metal into an elastic, cloud-like resource that you can easily provision, monitor, and manage.
With MAAS, you no longer need to manage individual servers manually. Instead, you can enlist bare metal servers and deploy standard or customized operating systems to them remotely. This allows you to rapidly deploy, destroy, and reconfigure your physical servers as needed.
Some key benefits of using MAAS include:
- Automated remote operating system deployment to physical machines
- Ability to manage large fleets of physical servers as a flexible resource pool
- Monitoring and management of physical infrastructure from a central interface
- Rapid provisioning and tear down of bare metal server configurations
- Well suited for environments that require frequent rearranging of physical hardware
MAAS is applicable across many use cases that involve rapidly shifting bare metal infrastructure. Examples include banking, telecommunications, supercomputing, streaming media services, disaster recovery systems, and computer security analytics. By treating physical servers like virtual resources, MAAS brings cloud-like agility to bare metal environments.
MAAS comprehensively meets the need to rapidly deploy, destroy, and reconfigure constellations of bare metal. Any application that requires frequently rearranging the server topology will benefit.
In this documentation
| Serve our study | Serve our work |
|---|---|
| Tutorials Hands-on introduction to MAAS features for new users | How-to guides Step-by-step guides covering key operations and common tasks |
| Explanation Detailed theory on the inner workings of MAAS | Reference Technical information - specifications, APIs, architecture |
Project and community
MAAS is a member of the Ubuntu family. Itβs an open source project that warmly welcomes community projects, contributions, suggestions, fixes and constructive feedback.
- Read our code of conduct
β - Get support
β - Learn about MAAS performance
- Join our online chat
- Contribute code
β - Improve our documentation
- Request a feature
- Report a bug
Considering MAAS for your next project? Get in touch
Navigation
[details=Navigation items] | Level | Path | Navlink | |-------|--------------------------------------------|--------------------------------------------------------------------------------| | 0 | / | MAAS Documentation | | 0 | | | | 1 | tutorials | Tutorials | | 2 | bootstrap-maas | Bootstrap MAAS | | 2 | try-out-the-maas-cli | Try out the MAAS CLI | | 2 | create-custom-images | Create custom images | | 2 | get-fancy-cli-output | Get fancy CLI output | | 0 | | | | 1 | how-to-guides | How-to guides | | 2 | setting-up-and-configuring-maas | Setting up and configuring MAAS | | 3 | fresh-installation-of-maas | Fresh installation of MAAS | | 3 | upgrading-maas | Upgrading MAAS | | 3 | backing-up-maas | Backing up MAAS | | 2 | networking-management | Networking management | | 3 | connecting-maas-networks | Connecting MAAS networks | | 3 | enabling-dhcp | Enabling DHCP | | 3 | using-availability-zones | Using availability zones | | 2 | image-management-and-customisation | Image management and customisation | | 3 | working-with-standard-images | Working with standard images | | 3 | mirroring-images-locally | Mirroring images locally | | 3 | customising-images-for-specific-needs | Customising images for specific needs | | 3 | integrating-vmware-images | Integrating VMWare images | | 3 | deploying-a-real-time-kernel | Deploying a real-time kernel | | 2 | controller-configuration | Controller configuration | | 3 | configuring-maas-controllers | Configuring MAAS controllers | | 3 | ensuring-high-availability-for-controllers | Ensuring high availability for controllers | | 2 | machine-and-device-management | Machine and device management | | 3 | making-machines-available-for-deployment | Making machines available for deployment | | 3 | customising-machine-specifications | Customising machine specifications | | 3 | deploying-machines-in-maas | Deploying machines in MAAS | | 2 | virtual-machine-management | Virtual machine management | | 3 | setting-up-lxd-for-vms | Setting up LXD for VMs | | 3 | managing-vm-hosts | Managing VM hosts | | 3 | overseeing-individual-virtual-machines | Overseeing individual virtual machines | | 2 | device-labelling-and-annotations | Device labelling and annotations | | 3 | tagging-machines-and-controllers | Tagging machines and controllers | | 3 | annotating-machine-details | Annotating machine details | | 3 | using-machine-tags | Using machine tags | | 3 | using-controller-tags | Using controller tags | | 3 | using-storage-tags | Using storage tags | | 3 | using-network-tags | Using network tags | | 2 | security-and-user-management | Security and user management | | 3 | enhancing-maas-security | Enhancing MAAS security | | 3 | managing-user-accounts-and-access | Managing user accounts and access | | 3 | implementing-maas-native-tls | Implementing MAAS native TLS | | 3 | integrating-vault-with-maas | Integrating Vault with MAAS | | 3 | configuring-an-air-gapped-maas-environment | Configuring an air-gapped MAAS environment | | 2 | operations-and-maintenance | Operations and maintenance | | 3 | locating-and-searching-for-machines | Locating and searching for machines | | 3 | monitoring-maas-activities | Monitoring MAAS activities | | 3 | auditing-maas-operations | Auditing MAAS operations | | 3 | troubleshooting-common-maas-issues | Troubleshooting common MAAS issues | | 2 | community-and-support | Community and support | | 3 | engaging-on-the-discourse-forum | Engaging on the Discourse forum | | 3 | seeking-maas-support | Seeking MAAS support | | 3 | requesting-features-and-enhancements | Requesting features and enhancements | | 3 | reporting-and-reviewing-bugs | Reporting and reviewing bugs | | 3 | contributing-to-maas-documentation | Contributing to MAAS documentation | | 0 | | | | 1 | reference | Reference | | 2 | general-information | General information | | 3 | installation-requirements | Installation requirements | | 3 | maas-settings | MAAS settings | | 3 | upgrading-postgresql-12-to-version-14 | Upgrading PostgreSQL v12 to v14 | | 3 | maas-source-code | MAAS source code | | 3 | documentation-style-guide | Documentation style guide | | 3 | maas-glossary | MAAS glossary | | 3 | maas-community-code-of-conduct | MAAS community code of conduct | | 2 | maas-api-integration | MAAS API integration | | 3 | authenticating-to-the-maas-api | Authenticating to the MAAS API | | 3 | utilizing-the-python-api-client | Utilizing the Python API client | | 3 | detailed-api-documentation | Detailed API documentation | | 2 | scripts-and-automation-with-MAAS | Scripts and automation with MAAS | | 3 | using-commissioning-scripts | Using commissioning scripts | | 3 | implementing-hardware-test-scripts | Integrating hardware test scripts | | 3 | integrating-with-terraform-for-iac | Integrating with Terraform for IAC | | 2 | logging-and-auditing | Logging and auditing | | 3 | understanding-event-logs | Understanding event logs | | 3 | reviewing-audit-logs | Reviewing audit logs | | 3 | accessing-commissioning-logs | Accessing commissioning logs | | 3 | interpreting-testing-logs | Interpreting testing logs | | 2 | machine-configuration-parameters | Machine configuration parameters | | 3 | setting-up-power-drivers | Setting up power drivers | | 3 | configuring-storage-layouts | Configuring storage layouts | | 3 | labelling-devices-for-maas | Labelling devices for MAAS | | 2 | maas-metrics-reference | MAAS metrics reference | | 2 | release-notes-and-version-details | Release notes and version details | | 3 | what-is-new-with-maas-3-4 | MAAS 3.4 release notes | | 3 | what-is-new-with-maas-3-3 | MAAS 3.3 release notes | | 3 | what-is-new-with-maas-3-2 | MAAS 3.2 release notes | | 3 | what-is-new-with-maas-3-1 | MAAS 3.1 release notes | | 3 | what-is-new-with-maas-3-0 | MAAS 3.0 release notes | | 3 | what-is-new-with-maas-2-9 | MAAS 2.9 release notes | | 3 | what-is-new-with-maas-2-8 | MAAS 2.8 release notes | | 3 | what-is-new-with-maas-2-7 | MAAS 2.7 release notes | | 0 | | | | 1 | explanation | Explanation | | 2 | overview-of-maas | Overview of MAAS | | 2 | core-components | Core components | | 3 | controllers-understanding-region-and-rack | Controllers: Understanding region and rack | | 3 | achieving-high-availability-in-maas | Achieving high availability in MAAS | | 3 | machines | Machines | | 3 | virtual-machines | Virtual machines | | 3 | labelling-devices-in-maas | Labelling devices in MAAS | | 3 | the-importance-of-images-in-maas | The importance of images in MAAS | | 2 | networking-insights | Networking insights | | 3 | the-role-of-maas-networks | The role of MAAS networks | | 3 | a-primer-on-tcp-ip | A primer on TCP/IP | | 3 | basics-of-dhcp-in-maas | Basics of DHCP in MAAS | | 3 | cloud-networking-essentials-for-maas | Cloud networking essentials for MAAS | | 2 | monitoring-and-logging | Monitoring and logging | | 3 | an-overview-of-maas-events | An overview of MAAS events | | 3 | understanding-audit-events | Understanding audit events | | 3 | delving-into-maas-logging-practices | Delving into MAAS logging practices | | 2 | optimizing-maas-operations | Optimizing MAAS operations | | 3 | ensuring-security-in-maas | Ensuring security in MAAS | | 3 | boosting-maas-performance | Boosting MAAS performance | | | | |
[/details]
Redirects
[details=Mapping table] | PATH | LOCATION | |---------------------------------------------------------|--------------------------------------------------| | /docs/how-to-get-started-with-maas | /docs/setting-up-and-configuring-maas | | /docs/how-to-do-a-fresh-install-of-maas | /docs/fresh-installation-of-maas | | /docs/how-to-upgrade-maas | /docs/upgrading-maas | | /docs/how-to-manage-networking | /docs/networking-management | | /docs/how-to-connect-maas-networks | /docs/connecting-maas-networks | | /docs/how-to-enable-dhcp | /docs/enabling-dhcp | | /docs/how-to-use-availability-zones | /docs/using-availability-zones | | /docs/how-to-use-images | /docs/image-management-and-customisation | | /docs/how-to-use-standard-images | /docs/working-with-standard-images | | /docs/how-to-mirror-images-locally | /docs/mirroring-images-locally | | /docs/how-to-customise-images | /docs/customising-images-for-specific-needs | | /docs/how-to-employ-vmware-images | /docs/integrating-vmware-images | | /docs/deploying-a-real-time-kernel | /docs/deploying-a-real-time-kernel | | /docs/how-to-manage-controllers | /docs/controller-configuration | | /docs/how-to-configure-controllers | /docs/configuring-maas-controllers | | /docs/how-to-enable-high-availability | /docs/ensuring-high-availability-for-controllers | | /docs/how-to-manage-machines | /docs/machine-and-device-management | | /docs/how-to-make-machines-available | /docs/making-machines-available-for-deployment | | /docs/how-to-customise-machines | /docs/customising-machine-specifications | | /docs/how-to-put-machines-to-work | /docs/deploying-machines-in-maas | | /docs/how-to-use-virtual-machines | /docs/virtual-machine-management | | /docs/how-to-set-up-lxd | /docs/setting-up-lxd-for-vms | | /docs/how-to-manage-vm-hosts | /docs/managing-vm-hosts | | /docs/how-to-manage-virtual-machines | /docs/overseeing-individual-virtual-machines | | /docs/how-to-label-devices | /docs/device-labelling-and-annotations | | /docs/how-to-tag-machines | /docs/tagging-machines-and-controllers | | /docs/how-to-annotate-machines | /docs/annotating-machine-details | | /docs/how-to-use-machine-tags | /docs/using-machine-tags | | /docs/how-to-use-controller-tags | /docs/using-controllers-tags | | /docs/how-to-use-storage-tags | /docs/using-storage-tags | | /docs/how-to-use-network-tags | /docs/using-network-tags | | /docs/how-to-secure-maas | /docs/security-and-user-management | | /docs/how-to-improve-maas-security | /docs/enhacing-maas-security | | /docs/how-to-manage-user-accounts | /docs/managing-user-accounts-and-access | | /docs/how-to-enable-maas-native-tls | /docs/implementing-maas-native-tls | | /docs/how-to-use-hashicorp-vault-with-maas | /docs/integrating-vault-with-maas | | /docs/how-to-set-up-an-air-gapped-maas | /docs/configuring-an-air-gapped-maas-environment | | /docs/how-to-operate-maas | /docs/operations-and-maintenance | | /docs/how-to-find-machines | /docs/locating-and-searching-for-machines | | /docs/how-to-back-up-maas | /docs/backing-up-maas | | /docs/how-to-monitor-maas | /docs/monitoring-maas-activities | | /docs/how-to-audit-maas | /docs/auditing-maas-operations | | /docs/how-to-troubleshoot-maas | /docs/troubleshooting-common-maas-issues | | /docs/how-to-give-and-receive-help | /docs/community-and-support | | /docs/how-to-use-the-maas-discourse-forum | /docs/engaging-on-the-discourse-forum | | /docs/how-to-request-features | /docs/requesting-features-and-enhancements | | /docs/how-to-review-and-report-bugs | /docs/reporting-and-reviewing-bugs | | /docs/how-to-contribute-documentation | /docs/contributing-to-maas-documentation | | /docs/maas-release-notes | /docs/release-notes-and-version-details | | /docs/general-reference | /docs/general-information | | /docs/maas-settings-reference | /docs/maas-settings | | /docs/maas-documentation-style-guide | /docs/documentation-style-guide | | /docs/api-reference | /docs/maas-api-integration | | /docs/api-authentication-reference | /docs/authenticating-to-the-maas-api | | /docs/python-api-client-reference | /docs/utilizing-the-python-api-client | | /docs/scripts-reference | /docs/scripts-and-automation-with-maas | | /docs/commissioning-scripts-reference | /docs/using-commissioning-scripts | | /docs/hardware-test-scripts-reference | /docs/implementing-hardware-test-scripts | | /docs/maas-terraform-reference | /docs/integrating-with-terraform-for-iac | | /docs/log-reference | /docs/logging-and-auditing | | /docs/event-logs-reference | /docs/understanding-event-logs | | /docs/audit-event-logs-reference | /docs/reviewing-audit-events | | /docs/commissioning-logs-reference | /docs/accessing-commissioning-logs | | /docs/testing-logs-reference | /docs/interpreting-test-logs | | /docs/machine-parameters-reference | /docs/machine-configuration-parameters | | /docs/power-drivers-reference | /docs/setting-up-power-drivers | | /docs/storage-layouts-reference | /docs/configuring-storage-layouts | | /docs/device-labelling-reference | /docs/labelling-devices-for-maas | | /docs/metrics-reference | /docs/maas-maas-metrics-reference | | /docs/about-maas | /docs/overview-of-maas | | /docs/about-maas-networks | /docs/the-role-of-maas-networks | | /docs/about-tcp-ip-networks | /docs/a-primer-on-tcp-ip | | /docs/about-dhcp | /docs/basics-of-dhcp-in-maas | | /docs/about-cloud-networking | /docs/cloud-netwrking-essentials-for-maas | | /docs/about-images | /docs/the-importance-of-images-in-maas | | /docs/about-region-and-rack-controllers | /docs/controllers-understanding-region-and-rack | | /docs/about-high-availability | /docs/achieving-high-availability-in-maas | | /docs/about-machines | /docs/machines | | /docs/about-virtual-machines | /docs/virtual-machines | | /docs/about-device-labels | /docs/labelling-devices | | /docs/about-maas-events | /docs/an-an-overview-of-maas-events | | /docs/about-audit-events | /docs/understanding-audit-events-in-maas | | /docs/about-log-files | /docs/delving-into-maas-logging-practices | | /docs/about-maas-security | /docs/ensuring-security-in-maas | | /docs/about-maas-performance | /docs/boosting-maas-performance | | /docs/2.8/release-notes | /docs/what-is-new-with-maas-2-8 | | /docs/overview-of-maas-audit-events | /docs/understanding-audit-events-in-maas | | /docs/about-networking | /docs/the-role-of-maas-networks | | /docs/about-rbac | /docs/ensuring-security-in-maas | | /docs/about-tags | /docs/labelling-devices | | /docs/about-tags-and-annotations | /docs/labelling-devices | | /docs/about-vm-hosting | /docs/virtual-machines | | /docs/add-an-rsd-host | /docs/virtual-machines | | /docs/audit-event-logging-and-auditing | /docs/audit-events-logs-reference | | /docs/audit-event-logs | /docs/understanding-audit-events-in-maas | | /docs/basic-tutorials | /docs/tutorials | | /docs/cli-tag-management | /docs/tagging-machines-and-controllers | | /docs/commissioning-logging-and-auditing | /docs/accessing-commissioning-logs | | /docs/commissioning-logs | /docs/delving-into-maas-logging-practices | | /docs/commissioning-script-reference | /docs/using-commissioning-scripts | | /docs/commissioning-scripts-tech-reference | /docs/using-commissioning-scripts | | /docs/configuration-settings-reference | /docs/maas-settings | | /docs/configure-networking | /docs/connecting-maas-networks | | /docs/contact-us | /docs/community-and-support | | /docs/contributing-build | /docs/how-to-give-and-recieve-help | | /docs/contributing-en-GB | /docs/contributing-to-maas-documentation | | /docs/contributing-git | /docs/community-and-support | | /docs/contributing-writing | /docs/contributing-to-maas-documentation | | /docs/create-a-custom-image | /docs/create-custom-images | | /docs/custom-image-tutorial | /docs/create-custom-images | | /docs/deb/2.7/cli/machines | /docs/machines | | /docs/deb/2.7/cli/about-networking | /docs/the-role-of-maas-networks | | /docs/deb/2.7/cli/add-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.7/cli/custom-machine-setup | /docs/customising-machine-specifications | | /docs/deb/2.7/cli/custom-machine-setup | /docs/customising-machine-specifications | | /docs/deb/2.7/cli/deploy-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.7/cli/customising-machine-specifications | /docs/customising-machine-specifications | | /docs/deb/2.7/cli/how-to-deploy-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.7/cli/machine-and-device-management | /docs/machine-and-device-management | | /docs/deb/2.7/cli/how-to-manage-networks | /docs/networking-management | | /docs/deb/2.7/cli/managing-vm-hosts | /docs/managing-vm-hosts | | /docs/deb/2.7/cli/maas-tags | /docs/labelling-devices | | /docs/deb/2.7/cli/machines | /docs/machines | | /docs/deb/2.7/cli/network-discovery | /docs/the-role-of-maas-networks | | /docs/deb/2.7/cli/networking | /docs/the-role-of-maas-networks | | /docs/deb/2.7/cli/tags-and-annotations | /docs/labelling-devices | | /docs/deb/2.7/cli/vm-host-networking | /docs/about-mass-networks | | /docs/deb/2.7/ui/machines | /docs/machines | | /docs/deb/2.7/ui/about-networking | /docs/the-role-of-maas-networks | | /docs/deb/2.7/ui/add-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.7/ui/custom-machine-setup | /docs/customising-machine-specifications | | /docs/deb/2.7/ui/deploy-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.7/ui/customising-machine-specifications | /docs/customising-machine-specifications | | /docs/deb/2.7/ui/how-to-deploy-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.7/ui/machine-and-device-management | /docs/machine-and-device-management | | /docs/deb/2.7/ui/how-to-manage-networks | /docs/networking-management | | /docs/deb/2.7/ui/managing-vm-hosts | /docs/managing-vm-hosts | | /docs/deb/2.7/ui/maas-tags | /docs/labelling-devices | | /docs/deb/2.7/ui/machines | /docs/machines | | /docs/deb/2.7/ui/network-discovery | /docs/the-role-of-maas-networks | | /docs/deb/2.7/ui/networking | /docs/the-role-of-maas-networks | | /docs/deb/2.7/ui/tags-and-annotations | /docs/labelling-devices | | /docs/deb/2.7/ui/vm-host-networking | /docs/the-role-of-maas-networks | | /docs/deb/2.8/cli/machines | /docs/machines | | /docs/deb/2.8/cli/about-networking | /docs/the-role-of-maas-networks | | /docs/deb/2.8/cli/add-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.8/cli/custom-machine-setup | /docs/customising-machine-specifications | | /docs/deb/2.8/cli/deploy-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.8/cli/customising-machine-specifications | /docs/customising-machine-specifications | | /docs/deb/2.8/cli/how-to-deploy-machines | /docs/how-to-deploy-machines | | /docs/deb/2.8/cli/machine-and-device-management | /docs/machine-and-device-management | | /docs/deb/2.8/cli/how-to-manage-networks | /docs/networking-management | | /docs/deb/2.8/cli/managing-vm-hosts | /docs/managing-vm-hosts | | /docs/deb/2.8/cli/maas-tags | /docs/labelling-devices | | /docs/deb/2.8/cli/machines | /docs/machines | | /docs/deb/2.8/cli/network-discovery | /docs/the-role-of-maas-networks | | /docs/deb/2.8/cli/networking | /docs/the-role-of-maas-networks | | /docs/deb/2.8/cli/tags-and-annotations | /docs/labelling-devices | | /docs/deb/2.8/cli/vm-host-networking | /docs/the-role-of-maas-networks | | /docs/deb/2.8/ui/machines | /docs/machines | | /docs/deb/2.8/ui/about-networking | /docs/the-role-of-maas-networks | | /docs/deb/2.8/ui/add-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.8/ui/custom-machine-setup | /docs/customising-machine-specifications | | /docs/deb/2.8/ui/deploy-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.8/ui/customising-machine-specifications | /docs/customising-machine-specifications | | /docs/deb/2.8/ui/how-to-deploy-machines | /docs/deploying-machines-in-maas | | /docs/deb/2.8/ui/machine-and-device-management | /docs/machine-and-device-management | | /docs/deb/2.8/ui/how-to-manage-networks | /docs/networking-management | | /docs/deb/2.8/ui/managing-vm-hosts | /docs/managing-vm-hosts | | /docs/deb/2.8/ui/kernel-boot-options | /docs/customising-machine-specifications | | /docs/deb/2.8/ui/maas-tags | /docs/labelling-devices | | /docs/deb/2.8/ui/machines | /docs/machines | | /docs/deb/2.8/ui/network-discovery | /docs/the-role-of-maas-networks | | /docs/deb/2.8/ui/networking | /docs/the-role-of-maas-networks | | /docs/deb/2.8/ui/tags-and-annotations | /docs/labelling-devices | | /docs/deb/2.8/ui/vm-host-networking | /docs/the-role-of-maas-networks | | /docs/deb/2.9/cli/audit-event-logs | /docs/understanding-audit-events-in-maas | | /docs/deb/2.9/cli/commissioning-logs | /docs/accessing-commissioning-logs | | /docs/deb/2.9/cli/contact-us | /docs/community-and-support | | /docs/deb/2.9/cli/event-logs | /docs/an-overview-of-maas-events | | /docs/deb/2.9/cli/give-me-an-example-of-maas | /docs/bootstrap-maas | | /docs/deb/2.9/cli/hardware-testing | /docs/implementing-hardware-test-scripts | | /docs/deb/2.9/cli/how-to-manage-networks | /docs/networking-management | | /docs/deb/2.9/cli/how-to-manage-tags | /docs/device-labelling-and-annotations | | /docs/deb/2.9/cli/maas-tags | /docs/labelling-devices | | /docs/deb/2.9/cli/manage-machine-interfaces | /docs/deploying-machines-in-maas | | /docs/deb/2.9/cli/ntp-services | /docs/the-role-of-maas-networks | | /docs/deb/2.9/cli/proxy | /docs/controllers-understanding-region-and-rack | | /docs/deb/2.9/cli/tags-and-annotations | /docs/labelling-devices | | /docs/deb/2.9/cli/tips-tricks-and-traps | /docs/troubleshooting-common-maas-issues | | /docs/deb/2.9/cli/vm-host-storage-pools | /docs/virtual-machines | | /docs/deb/2.9/cli/vm-hosting | /docs/virtual-machines | | /docs/deb/2.9/cli/writing-guide | /docs/documentation-style-guide | | /docs/deb/2.9/ui/audit-event-logs | /docs/understanding-audit-events-in-maas | | /docs/deb/2.9/ui/commissioning-logs | /docs/accessing-commissioning-logs | | /docs/deb/2.9/ui/contact-us | /docs/community-and-support | | /docs/deb/2.9/ui/event-logs | /docs/an-overview-of-maas-events | | /docs/deb/2.9/ui/give-me-an-example-of-maas | /docs/bootstrap-maas | | /docs/deb/2.9/ui/hardware-testing | /docs/implementing-hardware-test-scripts | | /docs/deb/2.9/ui/how-to-manage-networks | /docs/networking-management | | /docs/deb/2.9/ui/how-to-manage-tags | /docs/device-labelling-and-annotations | | /docs/deb/2.9/ui/manage-machine-interfaces | /docs/deploying-machines-in-maas | | /docs/deb/2.9/ui/network-testing | /docs/the-role-of-maas-networks | | /docs/deb/2.9/ui/ntp-services | /docs/the-role-of-maas-networks | | /docs/deb/2.9/ui/proxy | /docs/controllers-understanding-region-and-rack | | /docs/deb/2.9/ui/tips-tricks-and-traps | /docs/troubleshooting-common-maas-issues | | /docs/deb/2.9/ui/vm-host-storage-pools | /docs/virtual-machines | | /docs/deb/2.9/ui/vm-hosting | /docs/virtual-machines | | /docs/deb/2.9/ui/writing-guide | /docs/documentation-style-guide | | /docs/deb/3.0/cli/audit-event-logs | /docs/understanding-audit-events-in-maas | | /docs/deb/3.0/cli/commissioning-logs | /docs/accessing-commissioning-logs | | /docs/deb/3.0/cli/contact-us | /docs/community-and-support | | /docs/deb/3.0/cli/event-logs | /docs/an-overview-of-maas-events | | /docs/deb/3.0/cli/give-me-an-example-of-maas | /docs/bootstrap-maas | | /docs/deb/3.0/cli/hardware-testing | /docs/implementing-hardware-test-scripts | | /docs/deb/3.0/cli/how-to-manage-networks | /docs/networking-management | | /docs/deb/3.0/cli/how-to-manage-tags | /docs/device-labelling-and-annotations | | /docs/deb/3.0/cli/how-to-work-with-tags | /docs/labelling-devices | | /docs/deb/3.0/cli/manage-machine-interfaces | /docs/deploying-machines-in-maas | | /docs/deb/3.0/cli/network-testing | /docs/the-role-of-maas-networks | | /docs/deb/3.0/cli/ntp-services | /docs/the-role-of-maas-networks | | /docs/deb/3.0/cli/proxy | /docs/controllers-understanding-region-and-rack | | /docs/deb/3.0/cli/tips-tricks-and-traps | /docs/troubleshooting-common-maas-issues | | /docs/deb/3.0/cli/vm-host-storage-pools | /docs/virtual-machines | | /docs/deb/3.0/cli/vm-hosting | /docs/virtual-machines | | /docs/deb/3.0/cli/writing-guide | /docs/documentation-style-guide | | /docs/deb/3.0/ui/audit-event-logs | /docs/understanding-audit-events-in-maas | | /docs/deb/3.0/ui/commissioning-logs | /docs/accessing-commissioning-logs | | /docs/deb/3.0/ui/contact-us | /docs/community-and-support | | /docs/deb/3.0/ui/event-logs | /docs/an-overview-of-maas-events | | /docs/deb/3.0/ui/give-me-an-example-of-maas | /docs/bootstrap-maas | | /docs/deb/3.0/ui/hardware-testing | /docs/implementing-hardware-test-scripts | | /docs/deb/3.0/ui/how-to-manage-networks | /docs/networking-management | | /docs/deb/3.0/ui/how-to-manage-tags | /docs/device-labelling-and-annotations | | /docs/deb/3.0/ui/how-to-work-with-tags | /docs/labelling-devices | | /docs/deb/3.0/ui/manage-machine-interfaces | /docs/deploying-machines-in-maas | | /docs/deb/3.0/ui/network-testing | /docs/the-role-of-maas-networks | | /docs/deb/3.0/ui/ntp-services | /docs/the-role-of-maas-networks | | /docs/deb/3.0/ui/proxy | /docs/controllers-understanding-region-and-rack | | /docs/deb/3.0/ui/tips-tricks-and-traps | /docs/troubleshooting-common-maas-issues | | /docs/deb/3.0/ui/vm-host-storage-pools | /docs/virtual-machines | | /docs/deb/3.0/ui/vm-hosting | /docs/virtual-machines | | /docs/deb/3.0/ui/writing-guide | /docs/documentation-style-guide | | /docs/deb/3.1/cli/audit-event-logs | /docs/understanding-audit-events-in-maas | | /docs/deb/3.1/cli/commissioning-logs | /docs/accessing-commissioning-logs | | /docs/deb/3.1/cli/contact-us | /docs/community-and-support | | /docs/deb/3.1/cli/event-logs | /docs/an-overview-of-maas-events | | /docs/deb/3.1/cli/give-me-an-example-of-maas | /docs/bootstrap-maas | | /docs/deb/3.1/cli/how-to-manage-networks | /docs/networking-management | | /docs/deb/3.1/cli/how-to-manage-tags | /docs/device-labelling-and-annotations | | /docs/deb/3.1/cli/how-to-work-with-tags | /docs/labelling-devices | | /docs/deb/3.1/cli/manage-machine-interfaces | /docs/deploying-machines-in-maas | | /docs/deb/3.1/cli/proxy | /docs/controllers-understanding-region-and-rack | | /docs/deb/3.1/cli/tips-tricks-and-traps | /docs/troubleshooting-common-maas-issues | | /docs/deb/3.1/cli/vm-hosting | /docs/virtual-machines | | /docs/deb/3.1/cli/writing-guide | /docs/documentation-style-guide | | /docs/deb/3.1/ui/audit-event-logs | /docs/understanding-audit-events-in-maas | | /docs/deb/3.1/ui/commissioning-logs | /docs/accessing-commissioning-logs | | /docs/deb/3.1/ui/contact-us | /docs/community-and-support | | /docs/deb/3.1/ui/event-logs | /docs/an-overview-of-maas-events | | /docs/deb/3.1/ui/give-me-an-example-of-maas | /docs/bootstrap-maas | | /docs/deb/3.1/ui/how-to-manage-networks | /docs/networking-management | | /docs/deb/3.1/ui/how-to-manage-tags | /docs/device-labelling-and-annotations | | /docs/deb/3.1/ui/how-to-work-with-tags | /docs/labelling-devices | | /docs/deb/3.1/ui/manage-machine-interfaces | /docs/deploying-machines-in-maas | | /docs/deb/3.1/ui/proxy | /docs/controllers-understanding-region-and-rack | | /docs/deb/3.1/ui/tips-tricks-and-traps | /docs/troubleshooting-common-maas-issues | | /docs/deb/3.1/ui/vm-hosting | /docs/virtual-machines | | /docs/deb/3.1/ui/writing-guide | /docs/documentation-style-guide | | /docs/deploy-nodes | /docs/deploying-machines-in-maas | | /docs/documentation-index | /docs/maas-documentation | | /docs/event-logging-and-auditing | /docs/understanding-event-logs | | /docs/get-started-with-maas | /docs/setting-up-and-configuring-maas | | /docs/hardware-testing-scripts-and-automation-with-maas | /docs/implementing-hardware-test-scripts | | /docs/historical-release-notes | /docs/what-is-new-with-maas | | /docs/how-to-acquire-images | /docs/image-management-and-customisation | | /docs/how-to-adjust-your-controllers | /docs/configuring-maas-controllers | | /docs/how-to-ask-for-help | /docs/community-and-support | | /docs/how-to-build-maas-images | /docs/customising-images-for-specific-needs | | /docs/how-to-change-maas-settings | /docs/maas-settings | | /docs/how-to-choose-images | /docs/image-management-and-customisation | | /docs/how-to-configure-networking | /docs/how-to-set-up-networks | | /docs/how-to-contact-us | /docs/community-and-support | | /docs/how-to-create-a-custom-ubuntu-image | /docs/customising-images-for-specific-needs | | /docs/how-to-create-and-manage-vms | /docs/overseeing-individual-virtual-machines | | /docs/how-to-create-custom-images | /docs/customising-images-for-specific-needs | | /docs/how-to-create-vm-hosts | /docs/managing-vm-hosts | | /docs/how-to-deploy-maas | /docs/machine-and-device-management | | /docs/how-to-deploy-machines | /docs/deploying-machines-in-maas | | /docs/how-to-deploy-virtual-machines | /docs/virtual-machine-management | | /docs/how-to-diagnose-issues | /docs/troubleshooting-common-maas-issues | | /docs/how-to-enable-tls-encryption | /docs/implementing-maas-native-tls | | /docs/how-to-enable-vault | /docs/integrating-vault-with-maas | | /docs/how-to-gauge-maas-performance | /docs/boosting-maas-performance | | /docs/how-to-get-help | /docs/community-and-support | | /docs/how-to-get-maas-running | /docs/setting-up-and-configuring-maas | | /docs/how-to-help-improve-the-doc | /docs/documentation-style-guide | | /docs/how-to-import-images | /docs/how-use-standard-images | | /docs/how-to-install-maas | /docs/fresh-installation-of-maas | | /docs/how-to-keep-maas-backed-up | /docs/backing-up-maas | | /docs/device-labelling-and-annotations | /docs/device-labelling-and-annotations | | /docs/how-to-manage-availability-zones | /docs/using-availability-zones | | /docs/how-to-manage-dhcp | /docs/enabling-dhcp | | /docs/how-to-manage-ip-addresses | /docs/enabling-dhcp | | /docs/how-to-manage-ip-ranges | /docs/enabling-dhcp | | /docs/how-to-manage-maas | /docs/operations-and-maintenance | | /docs/how-to-manage-machine-interfaces | /docs/connecting-maas-networks | | /docs/how-to-manage-networks | /docs/networking-management | | /docs/how-to-manage-proxies | /docs/connecting-maas-networks | | /docs/how-to-manage-racks | /docs/configuring-maas-controllers | | /docs/how-to-manage-regions | /docs/configuring-maas-controllers | | /docs/how-to-manage-tags | /docs/device-labelling-and-annotations | | /docs/how-to-manage-vm-hoss | /docs/overseeing-individual-virtual-machines | | /docs/how-to-manage-vms | /docs/overseeing-individual-virtual-machines | | /docs/how-to-manage-vmware-images | /docs/integrating-vmware-images | | /docs/how-to-observe-a-live-maas | /docs/monitoring-maas-activities | | /docs/how-to-protect-your-secrets | /docs/security-and-user-management | | /docs/how-to-report-a-bug | /docs/reporting-and-reviewing-bugs | | /docs/how-to-request-a-feature | /docs/requesting-features-and-enhancements | | /docs/how-to-request-new-features | /docs/requesting-features-and-enhancements | | /docs/how-to-search-maas | /docs/locating-and-searching-for-machines | | /docs/how-to-set-up-maas-metrics | /docs/monitoring-maas-activities | | /docs/how-to-set-up-ntp | /docs/connecting-maas-networks | | /docs/how-to-set-up-ntp-services | /docs/connecting-maas-networks | | /docs/how-to-terraform-with-maas | /docs/integrating-with-terraform-for-iac | | /docs/how-to-test-machines | /docs/deploying-machines-in-maas | | /docs/how-to-tune-controllers | /docs/controller-configuration | | /docs/how-to-unseal-vault | /docs/integrating-vault-with-maas | | /docs/how-to-use-image-streams | /docs/how-use-standard-images | | /docs/how-to-use-lxd | /docs/setting-up-lxd-for-vms | | /docs/how-to-use-maas-in-an-air-gapped-environment | /docs/configuring-an-air-gapped-maas-environment | | /docs/how-to-use-tags | /docs/tagging-machines-and-controllers | | /docs/how-to-use-the-maas-cli | /docs/try-out-the-maas-cli | | /docs/how-to-work-with-annotations | /docs/annotating-machine-details | | /docs/how-to-work-with-audit-event-logs | /docs/auditing-maas-operations | | /docs/delving-into-maas-logging-practices | /docs/delving-into-maas-logging-practices | | /docs/how-to-work-with-tags | /docs/tagging-machines-and-controllers | | /docs/maas-installation-requirements | /docs/installation-requirements | | /docs/installconfig-network-ntp | /docs/connecting-maas-networks | | /docs/installconfig-network-proxy | /docs/connecting-maas-networks | | /docs/installconfig-network-subnet-management | /docs/connecting-maas-networks | | /docs/installconfig-networking | /docs/connecting-maas-networks | | /docs/installconfig-networking-config | /docs/connecting-maas-networks | | /docs/installconfig-package-install | /docs/fresh-installation-of-maas | | /docs/intro-to-vm-hosting | /docs/virtual-machines | | /docs/kvm-host-storage-pools | /docs/machines | | /docs/kvm-introduction | /docs/virtual-machines | | /docs/maas-bootstrap-tutorial | /docs/bootstrap-maas | | /docs/maas-concepts-and-terms-reference | /docs/maas-glossary | | /docs/maas-image-builder | /docs/customising-images-for-specific-needs | | /docs/maas-installation-requirements | /docs/installation-requirements | | /docs/maas-logging-reference | /docs/maas-logs-reference | | /docs/maas-performance | /docs/boosting-maas-performance | | /docs/maas-settings | /docs/maas-settings | | /docs/maas-tags | /docs/labelling-devices | | /docs/maas-technical-reference | /docs/reference | | /docs/maas-terraform-provider | /docs/integrating-with-terraform-for-iac | | /docs/maas-terraform-provider-reference | /docs/integrating-with-terraform-for-iac | | /docs/manage-audit-events | /docs/understanding-audit-events-in-maas | | /docs/manage-cli-interfaces | /docs/try-out-the-maas-cli | | /docs/manage-cli-tags | /docs/try-out-the-maas-cli | | /docs/manage-composable-machines | /docs/machines | | /docs/manage-ha-postgresql | /docs/achieving-high-availability-in-maas | | /docs/manage-kvm-intro | /docs/virtual-machines | | /docs/manage-kvm-storage | /docs/virtual-machines | | /docs/manage-pods-webui | /docs/virtual-machines | | /docs/power-management-reference | /docs/setting-up-power-drivers | | /docs/report-a-bug | /docs/reporting-and-reviewing-bugs | | /docs/request-a-feature | /docs/requesting-features-and-enhancements | | /docs/snap/2.7/cli/machines | /docs/machines | | /docs/snap/2.7/cli/about-networking | /docs/the-role-of-maas-networks | | /docs/snap/2.7/cli/add-machines | /docs/deploying-machines-in-maas | | /docs/snap/2.7/cli/custom-machine-setup | /docs/customising-machine-specifications | | /docs/snap/2.7/cli/upgrading-maas | /docs/upgrading-maas | | /docs/snap/2.7/cli/interactive-search | /docs/locating-and-searching-for-machines | | /docs/snap/2.7/ui/upgrading-maas | /docs/upgrading-maas | | /docs/snap/2.7/ui/interactive-search | /docs/locating-and-searching-for-machines | | /docs/snap/2.7/ui/whats-new-in-maas | /docs/what-is-new-with-maas-2-7 | | /docs/snap/2.8/cli/upgrading-maas | /docs/upgrading-maas | | /docs/snap/2.8/cli/interactive-search | /docs/locating-and-searching-for-machines | | /docs/snap/2.8/ui/upgrading-maas | /docs/upgrading-maas | | /docs/snap/2.8/ui/interactive-search | /docs/locating-and-searching-for-machines | | /docs/snap/2.9/cli/how-to-work-with-tags | /docs/tagging-machines-and-controllerss | | /docs/snap/2.9/ui/how-to-work-with-tags | /docs/tagging-machines-and-controllers | | /docs/snap/3.0/cli/how-to-work-with-tags | /docs/tagging-machines-and-controllers | | /docs/snap/3.0/ui/Overview-Of-Maas | /docs/overview-of-maas | | /docs/snap/3.0/ui/how-to-work-with-tags | /docs/tagging-machines-and-controllers | | /docs/snap/3.1/cli/how-to-work-with-tags | /docs/tagging-machines-and-controllers | | /docs/snap/3.1/ui/how-to-work-with-tags | /docs/tagging-machines-and-controllers | | /docs/ssl | /docs/implementing-maas-native-tls | | /docs/storage | /docs/machines#heading--machine-storage | | /docs/stp | /docs/connecting-maas-networks | | /docs/subnet-management | /docs/how-to-connect-maas-newtorks | | /docs/technical-reference | /docs/maas-technical-reference | | /docs/test-logging-and-auditing | /docs/interpreting-test-logs | | /docs/understanding-maas-audit-events | /docs/understanding-audit-events-in-maas | | /docs/understanding-maas-events | /docs/an-overview-of-maas-events | | /docs/using-jq-with-the-maas-cli | /docs/get-fancy-cli-output | | /docs/vmware-images | /docs/integrating-vmware-images | | /docs/whats-new-in-maas | /docs/what-is-new-with-maas | [/details]