MAAS Documentation (snap/2.8/UI)

2.7 2.8 2.9
Snap    CLI     UI        CLI     UI        CLI     UI    
Packages    CLI     UI        CLI     UI        CLI     UI    

MAAS is Metal As A Service, a service that lets you treat physical servers like virtual machines – instances – in the cloud. No need for you to manage servers individually: MAAS turns your bare metal into an elastic, cloud-like resource.

Quick questions you might have:

Part of the machine list from Metaphorical General Hospital, our example datacentre.


New version of MAAS


Getting support


Contribute

Navigation

Introduction

Installing MAAS

Controllers

Machines

Images

Networking

VM hosting

Operations

Concepts & terms

CLI

API documentation

Troubleshoot

Release notes

Help improve these docs

Contact us

URLs

Mapping table
TOPIC PATH
MAAS Documentation (snap/2.8/UI) /docs/
MAAS documentation (deb/2.7/CLI) /docs/deb/2.7/cli
MAAS documentation (deb/2.7/UI) /docs/deb/2.7/ui
MAAS documentation (deb/2.8/CLI) /docs/deb/2.8/cli
MAAS documentation (deb/2.8/UI) /docs/deb/2.8/ui
MAAS documentation (deb/2.9/CLI) /docs/deb/2.9/cli
MAAS documentation (deb/2.9/UI) /docs/deb/2.9/ui
MAAS Documentation (snap/2.7/CLI) /docs/snap/2.7/cli
MAAS Documentation (snap/2.7/UI) /docs/snap/2.7/ui
MAAS Documentation (snap/2.8/CLI) /docs/snap/2.8/cli
MAAS documentation (snap/2.9/CLI) /docs/snap/2.9/cli
MAAS documentation (snap/2.9/UI) /docs/snap/2.9/ui
RAD menu testing (deb/2.7/cli) /docs/deb/2.7/cli/menu-testing
RAD menu testing (deb/2.7/ui) /docs/deb/2.7/ui/menu-testing
RAD menu testing (deb/2.8/cli) /docs/deb/2.8/cli/menu-testing
RAD menu testing (deb/2.8/ui) /docs/deb/2.8/ui/menu-testing
RAD menu testing (deb/2.9/cli) /docs/deb/2.9/cli/menu-testing
RAD menu testing (deb/2.9/ui) /docs/deb/2.9/ui/menu-testing
RAD menu testing (snap/2.7/cli) /docs/snap/2.7/cli/menu-testing
RAD menu testing (snap/2.7/ui) /docs/snap/2.7/ui/menu-testing
RAD menu testing (snap/2.8/cli) /docs/snap/2.8/cli/menu-testing
RAD menu testing (snap/2.8/ui) /docs/snap/2.8/ui/menu-testing
RAD menu testing (snap/2.9/cli) /docs/snap/2.9/cli/menu-testing
RAD menu testing (snap/2.9/ui) /docs/snap/2.9/ui/menu-testing
Adding a VM host /docs/add-a-vm-host
Adding a VM host (UI) /docs/ui/add-a-vm-host
Test logs /docs/test-logs
Adding a VM host (CLI) /docs/cli/add-a-vm-host
VM host storage pools /docs/vm-host-storage-pools
VM host networking /docs/vm-host-networking
"Give me an example of MAAS" /docs/maas-example-config
Non-snap MAAS installs /docs/non-snap-maas-installs
Concepts and terms /docs/network-tutorial
API authentication /docs/api-authentication
Contact us /docs/contact-us
Tips, tricks, and traps /docs/tips-tricks-and-traps
Writing guide /docs/writing-guide
Block Devices /docs/block-devices
Enabling MAAS 2.7 (snap/UI) /docs/2.7/snap/ui
Enabling MAAS 2.8 (snap/UI) /docs/2.8/snap/ui
Enabling MAAS 2.7 (snap/CLI) /docs/2.7/snap/cli
Enabling MAAS 2.8 (snap/CLI) /docs/2.8/snap/cli
Enabling MAAS 2.7 (packages/UI) /docs/2.7/deb/ui
Enabling MAAS 2.8 (packages/UI) /docs/2.8/deb/ui
Enabling MAAS 2.7 (packages/CLI) /docs/2.7/deb/cli
Enabling MAAS 2.8 (packages/CLI) /docs/2.8/deb/cli
Select and import images /docs/select-and-import-images
Local image mirror /docs/local-image-mirror
VMWare images /docs/vmware-images
Images /docs/images
https://discourse.maas.io/t/installation/755/ /docs/install-from-a-snap
https://discourse.maas.io/t/install-from-iso/756/ /docs/install-from-iso
https://discourse.maas.io/t/install-with-lxd/757/ /docs/install-with-lxd
https://discourse.maas.io/t/network-discovery/758/ /docs/network-discovery
https://discourse.maas.io/t/dhcp/759/ /docs/dhcp
https://discourse.maas.io/t/ip-ranges/760/ /docs/ip-ranges
https://discourse.maas.io/t/ipv6/761/ /docs/ipv6
https://discourse.maas.io/t/ntp/762/ /docs/ntp
https://discourse.maas.io/t/proxy/763/ /docs/proxy
https://discourse.maas.io/t/ssl/764/ /docs/ssl
https://discourse.maas.io/t/stp/765/ /docs/stp
https://discourse.maas.io/t/subnet-management/766/ /docs/subnet-management
https://discourse.maas.io/t/configure-networking/767/ /docs/networking
https://discourse.maas.io/t/networking/768/ /docs/networking
https://discourse.maas.io/t/install-from-packages/769/ /docs/install-from-packages
https://discourse.maas.io/t/partitions/770/ /docs/partitions
https://discourse.maas.io/t/rack-controller/771/ /docs/rack-controller
https://discourse.maas.io/t/region-controller/772/ /docs/region-controller
https://discourse.maas.io/t/install-from-a-snap/773/ /docs/install-from-a-snap
https://discourse.maas.io/t/disk-erasure/774/ /docs/disk-erasure
https://discourse.maas.io/t/storage/775/ /docs/storage
https://discourse.maas.io/t/maas-logging/1468 /docs/logging
https://discourse.maas.io/t/commissioning-logs/1478 /docs/commissioning-logs
https://discourse.maas.io/t/upgrade-2-3-to-2-4-from-ubuntu-16-04/777/ /docs/upgrade-2-3-to-2-4-from-ubuntu-16-04
https://discourse.maas.io/t/upgrade-from-1-9-to-2-x/778/ /docs/upgrade-from-1-9-to-2-x
https://discourse.maas.io/t/upgrading-maas/779/ /docs/upgrading-maas
https://discourse.maas.io/t/vmware-vmfs-datastores/780/ /docs/vmware-vmfs-datastores
https://discourse.maas.io/t/configuration-journey/781/ /docs/configuration-journey
https://discourse.maas.io/t/web-ui/782/ /docs/web-ui
https://discourse.maas.io/t/maas-communcation/783/ /docs/maas-communication
https://discourse.maas.io/t/zone-examples/784/ /docs/zone-examples
https://discourse.maas.io/t/concepts-and-terms/785/ /docs/concepts-and-terms
https://discourse.maas.io/t/introduction-to-controllers/786/ /docs/introduction-to-controllers
https://discourse.maas.io/t/explore-maas/787/ /docs/explore-maas
https://discourse.maas.io/t/whats-new-in-2-6/788/ /docs/whats-new-in-2-6
https://discourse.maas.io/t/maas-requirements/789/ /docs/maas-requirements
https://discourse.maas.io/t/what-is-maas/840/ /docs/what-is-maas
https://discourse.maas.io/t/about-maas-ui/2063/ /docs/ui/what-is-maas
https://discourse.maas.io/t/what-is-maas-cli/1993/ /docs/cli/what-is-maas
https://discourse.maas.io/t/user-accounts/790/ /docs/user-accounts
https://discourse.maas.io/t/audit-event-logs/791/ /docs/audit-event-logs
https://discourse.maas.io/t/backup/792/ /docs/backup
https://discourse.maas.io/t/advanced-cli-tasks/793/ /docs/advanced-cli-tasks
https://discourse.maas.io/t/common-cli-tasks/794/ /docs/common-cli-tasks
https://discourse.maas.io/t/cli-composable-machines-management/795/ /docs/composable-hardware
https://discourse.maas.io/t/cli-dhcp-snippet-management/796/ /docs/cli-dhcp-snippet-management
https://discourse.maas.io/t/cli-image-management/797/ /docs/cli-image-management
https://discourse.maas.io/t/cli-interface-management/798/ /docs/cli-interface-management
https://discourse.maas.io/t/cli-kernel-management/799/ /docs/cli-kernel-management
https://discourse.maas.io/t/cli-resource-pool-management/800/ /docs/cli-resource-pool-management
https://discourse.maas.io/t/cli-tag-management/801/ /docs/cli-tag-management
https://discourse.maas.io/t/maas-cli/802/ /docs/maas-cli
https://discourse.maas.io/t/postgresql-ha-hot-standby/803/ /docs/postgresql-ha-hot-standby
https://discourse.maas.io/t/high-availability/804/ /docs/high-availability
https://discourse.maas.io/t/creating-and-deleting-new-vms/806/ /docs/creating-and-deleting-new-vms
https://discourse.maas.io/t/introduction-to-vm-hosting/1524 /docs/intro-to-vm-hosting
https://discourse.maas.io/t/api-client/810/ /docs/api-client
https://discourse.maas.io/t/hardening-your-maas-installation/1381 /docs/security
https://discourse.maas.io/t/prometheus-metrics/813/ /docs/prometheus-metrics
https://discourse.maas.io/t/package-repositories/814/ /docs/package-repositories
https://discourse.maas.io/t/add-an-rsd-host/815/ /docs/add-an-rsd-host
https://discourse.maas.io/t/creating-and-deleting-machines/816/ /docs/creating-and-deleting-machines
https://discourse.maas.io/t/intel-rack-scale-design-rsd-introduction/817/ /docs/intel-rack-scale-design-rsd-introduction
https://discourse.maas.io/t/rsd-storage/818/ /docs/rsd-storage
https://discourse.maas.io/t/interactive-search/819/ /docs/interactive-search
https://discourse.maas.io/t/availability-zones/820/ /docs/availability-zones
https://discourse.maas.io/t/documentation-index/839/ /docs/documentation-index
https://discourse.maas.io/t/add-machines/821/ /docs/add-machines
https://discourse.maas.io/t/add-machines-cli/1995/ /docs/cli/add-machines
https://discourse.maas.io/t/add-machines-2-7-ui/2065/ /docs/2.7/ui/add-machines
https://discourse.maas.io/t/add-machines-2-8-ui/2187/ /docs/2.8/ui/add-machines
https://discourse.maas.io/t/commission-nodes/822/ /docs/commission-nodes
https://discourse.maas.io/t/custom-machine-setup/824/ /docs/custom-machine-setup
https://discourse.maas.io/t/custom-machine-setup-2-9-ui/2079/ /docs/2.9/ui/custom-machine-setup
https://discourse.maas.io/t/custom-machine-setup-cli/2009/ /docs/cli/custom-machine-setup
https://discourse.maas.io/t/jq-cookbook/2218/ /docs/jq-cookbook
https://discourse.maas.io/t/deploy-nodes/825/ /docs/deploy-nodes
https://discourse.maas.io/t/hardware-testing/826/ /docs/hardware-testing
https://discourse.maas.io/t/kernel-boot-options/827/ /docs/kernel-boot-options
https://discourse.maas.io/t/ubuntu-kernels/828/ /docs/ubuntu-kernels
https://discourse.maas.io/t/node-overview/829/ /docs/machine-overview
https://discourse.maas.io/t/bmc-power-types/830/ /docs/bmc-power-types
https://discourse.maas.io/t/resource-pools/831/ /docs/resource-pools
https://discourse.maas.io/t/cli-testing-scripts/832/ /docs/cli-testing-scripts
/t/cli-commissioning-and-hardware-testing-scripts/832 /docs/cli-testing-scripts
https://discourse.maas.io/t/commissioning-and-hardware-testing-scripts/833/ /docs/commissioning-and-hardware-testing-scripts
https://discourse.maas.io/t/tags/834/ /docs/tags
https://discourse.maas.io/t/historical-release-notes/835/ /docs/historical-release-notes
https://discourse.maas.io/t/troubleshooting/837/ /docs/troubleshooting
https://discourse.maas.io/t/getting-help/838/ /docs/getting-help
https://discourse.maas.io/t/historical-release-notes/835/ /docs/whats-new-in-2-6
https://discourse.maas.io/t/whats-new-in-maas-2-7/1306 /docs/whats-new-in-2-7
https://discourse.maas.io/t/historical-release-notes/835/ /docs/maas-2-7-release-notes
https://discourse.maas.io/t/whats-new-in-maas-2-8/1655 /docs/release-notes
https://discourse.maas.io/t/network-testing/1267 /docs/network-testing
https://discourse.maas.io/t/markdown-test/1561 /docs/markdown-test
https://discourse.maas.io/t/maas-image-builder/1112 /docs/image-builder
POTENTIALLY ORPHANED TOPIC (NEEDS CHECKING) PATH
https://discourse.maas.io/t/language-details-contributing-to-maas-docs/745/ /docs/language-details-contributing-to-maas-docs
DEPRECATED TOPIC (MAY NEED MARKING AS SUCH) PRESERVED PATH
https://discourse.maas.io/t/building-the-docs/744/ /docs/building-the-docs
https://discourse.maas.io/t/working-with-git-and-github/746/ /docs/working-with-git-and-github
https://discourse.maas.io/t/the-cli-cookbook/2218/ /docs/cli-cookbook
BOT ADD POINT DO NOT REMOVE THIS LINE

Redirects

Mapping table
PATH LOCATION
/docs/snap/2.8/ui /docs
/docs/snap /docs
/docs/snap/2.8 /docs
/docs/snap/2.7 /docs/snap/2.7/ui
/docs/snap/2.9 /docs/snap/2.9/ui
/docs/deb /docs/deb/2.8/ui
/docs/deb/2.8 /docs/deb/2.8/ui
/docs/deb/2.7 /docs/deb/2.7/ui
/docs/deb/2.9 /docs/deb/2.9/ui
/docs/pods /docs/intro-to-vm-hosting
/docs/manage-composable-machines /docs/intro-to-vm-hosting
/docs/kvm-introduction /docs/intro-to-vm-hosting
/docs/custom-node-setup-preseed /docs/custom-machine-setup
/docs/manage-kvm-intro /docs/intro-to-vm-hosting
/docs/add-a-kvm-host /docs/add-a-vm-host
/docs/manage-kvm-add-host /docs/add-a-vm-host
/docs/manage-kvm-storage /docs/vm-host-storage-pools
/docs/kvm-host-storage-pools /docs/vm-host-storage-pools
/docs/kvm-host-networking /docs/vm-host-networking
/docs/manage-kvm-host-networking /docs/vm-host-networking
-------------------------------------- -----------------------------------------
/docs/language-details-contributing-to-juju-docs /docs/language-details-contributing-to-maas-docs
/docs/contributing-build /docs/building-the-docs
/docs/contributing-en-GB /docs/language-details-contributing-to-juju-docs
/docs/contributing-git /docs/working-with-git-and-github
/docs/contributing-writing /docs/writing-guide
/docs/installconfig-block /docs/block-devices
/docs/installconfig-checklist /docs/installation-and-configuration-checklist
/docs/installconfig-images-import /docs/select-and-import-images
/docs/installconfig-images-mirror /docs/local-image-mirror
/docs/installconfig-images-vmware /docs/vmware-images
/docs/installconfig-images /docs/images
/docs/installconfig-install /docs/install-from-a-snap
/docs/installation /docs/install-from-a-snap
/docs/installconfig-iso-install /docs/install-from-iso
/docs/installconfig-lxd-install /docs/install-with-lxd
/docs/installconfig-network-dev-discovery /docs/network-discovery
/docs/installconfig-network-dhcp /docs/dhcp
/docs/installconfig-network-ipranges /docs/ip-ranges
/docs/installconfig-network-ipv6 /docs/ipv6
/docs/installconfig-network-ntp /docs/ntp
/docs/installconfig-network-proxy /docs/proxy
/docs/installconfig-network-ssl /docs/ssl
/docs/installconfig-network-stp /docs/stp
/docs/installconfig-network-subnet-management /docs/subnet-management
/docs/installconfig-networking-config /docs/networking
/docs/configure-networking /docs/networking
/docs/installconfig-networking /docs/networking
/docs/installconfig-package-install /docs/install-from-packages
/docs/installconfig-partitions /docs/partitions
/docs/installconfig-rack /docs/rack-controller
/docs/installconfig-region /docs/region-controller
/docs/installconfig-snap-install /docs/install-from-a-snap
/docs/installconfig-storage-erasure /docs/disk-erasure
/docs/installconfig-storage /docs/storage
/docs/installconfig-syslog /docs/syslog
/docs/installconfig-upgrade-postgres /docs/upgrade-2-3-to-2-4-from-ubuntu-16-04
/docs/installconfig-upgrade-to-2 /docs/upgrade-from-1-9-to-2-x
/docs/installconfig-upgrade /docs/upgrading-maas
/docs/installconfig-vmfs-datastores /docs/vmware-vmfs-datastores
/docs/installconfig-webui-conf-journey /docs/configuration-journey
/docs/installconfig-webui /docs/web-ui
/docs/intro-communication /docs/maas-communication
/docs/maas-communcation /docs/maas-communication
/docs/intro-concepts-zones /docs/zone-examples
/docs/intro-concepts /docs/concepts-and-terms
/docs/intro-controllers /docs/introduction-to-controllers
/docs/intro-explore /docs/explore-maas
/docs/intro-new /docs/whats-new-in-maas-2-7
/docs/intro-requirements /docs/what-is-maas
/docs/intro-what-is-maas /docs/what-is-maas
/docs/maas-security /docs/security
/docs/manage-account /docs/user-accounts
/docs/manage-audit-events /docs/audit-event-logs
/docs/manage-backup /docs/backup
/docs/manage-cli-advanced /docs/advanced-cli-tasks
/docs/manage-cli-common /docs/common-cli-tasks
/docs/manage-cli-comp-hw /docs/cli-composable-machines-management
/docs/manage-cli-dhcp-snippets /docs/cli-dhcp-snippet-management
/docs/manage-cli-images /docs/cli-image-management
/docs/manage-cli-interfaces /docs/cli-interface-management
/docs/manage-cli-kernels /docs/cli-kernel-management
/docs/manage-cli-resource-pools /docs/cli-resource-pool-management
/docs/manage-cli-tags /docs/cli-tag-management
/docs/manage-cli /docs/maas-cli
/docs/manage-ha-postgresql /docs/postgresql-ha-hot-standby
/docs/manage-ha /docs/high-availability
/docs/manage-kvm-create-vms /docs/creating-and-deleting-new-vms
/docs/manage-libmaas /docs/api-client
/docs/manage-maas-security /docs/security
/docs/manage-pods-webui /docs/manage-composable-machines
/docs/manage-prometheus-metrics /docs/prometheus-metrics
/docs/manage-repos /docs/package-repositories
/docs/manage-rsd-add /docs/add-an-rsd-host
/docs/manage-rsd-create /docs/creating-and-deleting-machines
/docs/manage-rsd-intro /docs/intel-rack-scale-design-rsd-introduction
/docs/manage-rsd-storage /docs/rsd-storage
/docs/manage-search /docs/interactive-search
/docs/manage-zones /docs/availability-zones
/docs/metadata.y /docs/documentation-index
/docs/nodes-add /docs/add-machines
/docs/add-nodes /docs/add-machines
/docs/nodes-commission /docs/commission-nodes
/docs/nodes-comp-hw /docs/intro-to-vm-hosting
/docs/nodes-custom /docs/custom-node-setup-preseed
/docs/nodes-deploy /docs/deploy-nodes
/docs/nodes-hw-testing /docs/hardware-testing
/docs/nodes-kernel-options /docs/kernel-boot-options
/docs/nodes-kernels /docs/ubuntu-kernels
/docs/nodes-overview /docs/machine-overview
/docs/node-overview /docs/machine-overview
/docs/nodes-power-types /docs/bmc-power-types
/docs/nodes-resource-pools /docs/resource-pools
/docs/nodes-scripts-cli /docs/cli-testing-scripts
/docs/nodes-scripts /docs/commissioning-and-hardware-testing-scripts
/docs/syslog /docs/logging
/docs/nodes-tags /docs/tags
/docs/release-notes-all /docs/historical-release-notes
/docs/release-notes /docs/maas-2-7-release-notes
/docs/troubleshoot-faq /docs/troubleshooting
/docs/troubleshoot-getting-help /docs/getting-help