--- title: How-to guides description: Canonical makes open source secure, reliable and easy to use, providing support for Ubuntu and a portfolio of enterprise-grade technologies. Founded in 2004, Canonical operates globally with team members in over 80 countries. url: https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md --- *Submit* # How-to guides This section provides practical, step-by-step guidance for getting the most out of MAAS — from planning your deployment to integrating with automation tools. Use this guide when you’re ready to apply MAAS in real-world scenarios and want clear, operational documentation. ## [Plan and prepare](https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md#p-13921-plan-and-prepare) Before installing anything, make sure MAAS is the right fit. Confirm that your intended use matches the reference architecture. Clarify your environment’s requirements, choose the right installation method (Snap vs. Deb), and decide on deployment targets: bare metal, VMs, or a mix. These choices will shape your entire setup. * [Examine and confirm requirements](https://canonical.com/maas/docs/installation-requirements) * [Choose the installation type](https://canonical.com/maas/docs/how-to-get-maas-up-and-running#p-9034-install-maas-snap-or-packages) ## [Install and set up](https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md#p-13921-install-and-set-up) Here, you’ll install and initialize MAAS, then configure it to manage your infrastructure. Whether you’re working with LXD, KVM, or another cloud provider, this section walks you through connecting MAAS to your virtual or physical environment. * [Install MAAS](https://canonical.com/maas/docs/how-to-get-maas-up-and-running) * [Initialize MAAS](https://canonical.com/maas/docs/how-to-get-maas-up-and-running#p-9034-post-install-setup-poc) * [Set up your cloud](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-enable-new-machines) ## [Provision and deploy](https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md#p-13921-provision-and-deploy) This section covers how to enlist machines into MAAS, test and commission them, and then deploy your desired OS or workloads. It also includes advanced topics like custom image creation, ephemeral deployments, and how to manage machines MAAS didn’t originally deploy. * [Enlist machines](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-discover-machines) * [Commission/test machines](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-commission-test-machines) * [Deploy machines](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-deploy-machines) * [Confirm deployment](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-ssh-into-a-machine-to-diagnose-issues) * [Customize deployment](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-configure-deployment) * Special deployments + [Custom images: building, using, and maintaining](https://canonical.com/maas/docs/how-to-build-custom-images) + [Ephemeral deployments](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-deploy-to-ram-ephemeral-deployment) ## [Manage MAAS](https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md#p-13921-manage-maas) Once your systems are running, it’s time to manage them effectively. Learn how to label machines with metadata (tags, zones, annotations), configure storage layouts, and handle networking at the fabric, VLAN, and subnet level—including advanced options like DHCP overrides and air gaps. * [Labeling machines](https://canonical.com/maas/docs/how-to-manage-machine-groups) + [Tags](https://canonical.com/maas/docs/how-to-manage-machine-groups#p-19384-tags-and-annotations) + [Resource pools](https://canonical.com/maas/docs/how-to-manage-machine-groups#p-19384-resource-pools) + [Availability zones](https://canonical.com/maas/docs/how-to-manage-machine-groups#p-19384-availability-zones) + [Notes](https://canonical.com/maas/docs/how-to-manage-machine-groups#p-19384-manage-notes) + [Annotations](https://canonical.com/maas/docs/how-to-manage-machine-groups#p-19384-manage-dynamic-annotations) * Storage + [Storage types](https://canonical.com/maas/docs/reference-maas-storage) + [Storage layout](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-configure-storage-layout) * [Networks](https://canonical.com/maas/docs/how-to-manage-networks) + [VLANs](https://canonical.com/maas/docs/how-to-manage-networks#p-9070-manage-vlans) + [Subnets](https://canonical.com/maas/docs/how-to-manage-networks#p-9070-manage-subnets) + [Special DNS / DHCP / NTP settings](https://canonical.com/maas/docs/how-to-manage-network-services) + [Creating an air gap](https://canonical.com/maas/docs/how-to-set-up-air-gapped-maas) * [Power control](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-control-machine-power) + [Specific machine types](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-set-power-type) ## [Monitor and troubleshoot](https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md#p-13921-monitor-and-troubleshoot) This section helps you observe and debug your MAAS deployment using tools like Prometheus and Loki. Learn to identify issues with logs, performance, or machine behavior—and get strategies for fixing common problems across your infrastructure. * [Using Prometheus and Loki](https://canonical.com/maas/docs/how-to-monitor-maas) * [Debugging via logs](https://canonical.com/maas/docs/how-to-use-logging) * [Auditing with logs](https://canonical.com/maas/docs/how-to-use-logging#p-14514-auditing-maas) * [Troubleshooting machine behaviors](https://canonical.com/maas/docs/how-to-manage-machines#p-9078-rescue-recovery) * [Troubleshooting network issues](https://canonical.com/maas/docs/maas-troubleshooting-guide) ## [Scale and optimize](https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md#p-13921-scale-and-optimize) Ready to grow? Learn how to replicate controllers for high availability, set up VM clusters, combine hardware and virtual setups, and handle complex deployments. This section is essential for production-grade MAAS installations. * [Setting up HA & controller replication](https://canonical.com/maas/docs/how-to-manage-high-availability) * [Advanced deployments](https://canonical.com/maas/docs/reference-terraform) ## [Automate and integrate](https://canonical-com-2934.demos.haus/maas/docs/how-to-guides?format=md#p-13921-automate-and-integrate) Finally, make MAAS part of your larger automation pipeline. Learn how to use the MAAS API, CLI scripting, Terraform, and integrate with tools like Charmed MAAS. Use this section to build repeatable, scalable provisioning workflows. * [Using the MAAS API](https://canonical.com/maas/docs/api) * [Using Terraform](https://canonical.com/maas/docs/reference-terraform) --- [Previous Tutorial](https://canonical-com-2934.demos.haus/maas/docs/maas-in-thirty-minutes) [Next Get MAAS up and running](https://canonical-com-2934.demos.haus/maas/docs/how-to-get-maas-up-and-running) Last updated 1 year, 1 month ago. [Help improve this document in the forum](https://discourse.maas.io/t/how-to-guides/6663).