---
title: "Tear down your OpenStack lab environment\n    | Ubuntu"
description: Ubuntu is an open source software operating system that runs from the
  desktop, to the cloud, to all your internet connected things.
url: https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md
keywords: index, follow
---

# Tear down your OpenStack lab environment

1. [Overview](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#1-overview)
2. [Stop and Sunbeam](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#2-stop-and-sunbeam)
3. [Disable and enable Sunbeam](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#3-disable-and-enable-sunbeam)
4. [Uninstall Sunbeam](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#4-uninstall-sunbeam)
5. [Next steps](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#5-next-steps)

## 1. Overview

### [Before you get started!](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#before-you-get-started)

Welcome to OpenStack!

In this series of tutorials, we will walk you through all the necessary steps to install, configure and get started with OpenStack. Using just a single machine, you will learn how to use OpenStack for cloud infrastructure implementation purposes, from a single-node installation to large-scale clusters.

This tutorial is the twelfth in the “Phase 1 - Learn OpenStack” series.

[Explore other tutorials >](https://ubuntu.com/openstack/tutorials)

### [What is OpenStack?](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#what-is-openstack)

[OpenStack](https://ubuntu.com/openstack/what-is-openstack) is a collection of open source projects designed to work together to form the basis of a cloud. OpenStack can be used for both private and public cloud implementation.

### [What is Sunbeam?](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#what-is-sunbeam)

[Sunbeam](https://governance.openstack.org/tc/reference/projects/sunbeam.html) is an upstream project under the governance of the OpenInfra Foundation (OIF), which was created to lower the barrier to entry for OpenStack, simplify its adoption process, and set the foundation for an autonomous private cloud. Sunbeam uses cloud-native architecture and total bottom-up automation to make OpenStack more accessible to newcomers and to help users get to grips with the platform immediately.

### [What is MicroStack?](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#what-is-microstack)

[MicroStack](https://microstack.run/) (based on Sunbeam) is an OpenStack distribution designed for small-scale cloud environments. While it is available with full commercial support from Canonical, it can also be self-deployed with no friction, effectively eliminating the need for a paid consulting engagement. MicroStack currently includes core OpenStack services only, but is expected to evolve quickly to ensure full feature parity with [Canonical’s Charmed OpenStack](https://ubuntu.com/openstack) soon.

### [In this tutorial, you will learn how to:](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#in-this-tutorial-you-will-learn-how-to)

* Stop and start Sunbeam
* Disable and enable Sunbeam
* Uninstall Sunbeam

### [You will only need:](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#you-will-only-need)

One fresh physical or virtual machine with:

* Ubuntu 22.04 LTS installed,
* Static IP address assigned to its primary network interface,
* OpenSSH server installed and configured,
* 4+ core amd64 CPU,
* 16 GB of RAM,
* 50 GB of SSD storage,
* [OpenStack cloud bootstrapped, configured and sample instance launched](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance).

---

[Suggest changes ›](https://discourse.ubuntu.com/t/tear-down-your-openstack-lab-environment/25078)

about
17
minutes to go

*Previous step*
[*Next step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#2-stop-and-sunbeam)

## 2. Stop and Sunbeam

Sunbeam can be stopped when not being used and started when needed again.

To stop Sunbeam, execute the following commands:

```
$ sudo snap stop microk8s
$ sudo snap stop openstack-hypervisor
```

To start Sunbeam, execute the following command:

```
$ sudo snap start openstack-hypervisor
$ sudo snap start microk8s
```

---

[Suggest changes ›](https://discourse.ubuntu.com/t/tear-down-your-openstack-lab-environment/25078)

about
12
minutes to go

[*Previous step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#1-overview)
[*Next step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#3-disable-and-enable-sunbeam)

## 3. Disable and enable Sunbeam

Sunbeam is set to start automatically on a reboot.

To disable Sunbeam, execute the following commands:

```
$ sudo snap disable microk8s
$ sudo snap disable openstack-hypervisor
```

To enable Sunbeam, execute the following command:

```
$ sudo snap enable microk8s
$ sudo snap enable openstack-hypervisor
```

---

[Suggest changes ›](https://discourse.ubuntu.com/t/tear-down-your-openstack-lab-environment/25078)

about
7
minutes to go

[*Previous step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#2-stop-and-sunbeam)
[*Next step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#4-uninstall-sunbeam)

## 4. Uninstall Sunbeam

In case you no longer need it, you can completely uninstall Sunbeam.

To uninstall Sunbeam, execute the following commands:

```
$ sudo snap remove --purge microk8s
$ sudo snap remove --purge juju
$ sudo snap remove --purge openstack
$ sudo snap remove --purge openstack-hypervisor
$ sudo /usr/sbin/remove-juju-services
$ sudo rm -rf /var/lib/juju
$ rm -rf ~/.local/share/juju
$ rm -rf ~/.local/share/openstack
$ rm -rf ~/snap/openstack
$ rm -rf ~/snap/openstack-hypervisor
$ rm -rf ~/snap/microstack/
$ rm -rf ~/snap/juju/
$ rm -rf ~/snap/microk8s/
$ sudo init 6
```

---

[Suggest changes ›](https://discourse.ubuntu.com/t/tear-down-your-openstack-lab-environment/25078)

about
2
minutes to go

[*Previous step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#3-disable-and-enable-sunbeam)
[*Next step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#5-next-steps)

## 5. Next steps

Congratulations! You have reached the end of this tutorial and the end of the “Phase 1 - Learn OpenStack” series.

You can now move to the next tutorial - [“1. Design”](https://ubuntu.com/tutorials/learn-which-design-considerations-to-take-into-account-when-architecting-the-cloud) - in the “Phase 2 - Deploy OpenStack” series or [explore other tutorials](https://ubuntu.com/openstack/tutorials).

### [In this tutorial, you have learnt how to:](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#in-this-tutorial-you-have-learnt-how-to)

* Stop and start MicroStack
* Disable and enable MicroStack
* Uninstall MicroStack

### [Where to go from here?](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#where-to-go-from-here)

* [Refer to Sunbeam documentation](https://microstack.run/docs)
* [Join the community and ask questions](https://matrix.to/#/#openstack-sunbeam:ubuntu.com)
* [Report a bug in Sunbeam](https://bugs.launchpad.net/snap-openstack/+filebug)
* [Explore Charmed OpenStack](https://ubuntu.com/openstack/features)

Was this tutorial useful?

---

[Suggest changes ›](https://discourse.ubuntu.com/t/tear-down-your-openstack-lab-environment/25078)

about
0
minutes to go

[*Previous step*](https://ubuntu.com/tutorials/tear-down-your-openstack-lab-environment?format=md#4-uninstall-sunbeam)

*Next step*
