--- title: "Install OpenStack and launch your first instance\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/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md keywords: index, follow --- # Install OpenStack and launch your first instance 1. [Overview](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#1-overview) 2. [Install OpenStack](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#2-install-openstack) 3. [Next steps](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#3-next-steps) ## 1. Overview ### [Before you get started!](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-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 first in the “Phase 1 - Learn OpenStack” series. [Explore other tutorials >](https://ubuntu.com/openstack/tutorials) ### [What is OpenStack?](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-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/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-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/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-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/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-in-this-tutorial-you-will-learn-how-to) * Install OpenStack with Sunbeam * Launch your first instance on OpenStack ### [You will only need:](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-you-will-only-need) One dedicated physical machine with: * 4+ core amd64 processor * minimum of 16 GiB of RAM * minimum of 100 GiB SSD storage on the `rootfs` partition * fresh Ubuntu 24.04 LTS installed * unlimited access to the Internet --- [Suggest changes ›](https://discourse.ubuntu.com/t/install-openstack-and-launch-your-first-instance/25065) about 32 minutes to go *Previous step* [*Next step*](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#2-install-openstack) ## 2. Install OpenStack We’re going to follow MicroStack quickstart installation instructions. Those aim to install OpenStack in the most straightforward way possible by making a number of assumptions. For more configurable installation, refer to [guided installation instructions](https://microstack.run/docs/single-node-guided). > ! **openstackclients** > If you have the openstackclients snap installed, you have to remove it first to avoid namespace conflict. Sunbeam ships with the latest version of the OpenStack client, so the openstackclients snap is redundant. ### [Install OpenStack](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-install-openstack) In order to install OpenStack, execute the following command: ``` $ sudo snap install openstack --channel 2024.1/candidate ``` ### [Install dependencies](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-install-dependencies) In order to install all necessary dependencies, execute the following command: ``` $ sunbeam prepare-node-script --bootstrap | bash -x && newgrp snap_daemon ``` ### [Bootstrap the cloud](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-bootstrap-the-cloud) In order to bootstrap the cloud, execute the following command: ``` $ sunbeam cluster bootstrap --accept-defaults --role control,compute,storage ``` This command takes a while to finish. Be patient. ### [Configure the cloud](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-configure-the-cloud) In order to configure the cloud with default options, execute the following command: ``` $ sunbeam configure --accept-defaults --openrc demo-openrc ``` For more advanced scenarios, refer to [guided installation instructions](https://microstack.run/docs/single-node-guided). ### [Launch an instance](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-launch-an-instance) In order to launch your first instance, execute the following command: ``` $ sunbeam launch ubuntu --name test ``` Sample output: ``` Access instance with `ssh -i /home/ubuntu/.config/openstack/sunbeam ubuntu@10.20.20.16` ``` At this point the instance should be accessible over the SSH protocol. In order to connect to it, execute the command from the output: ``` $ ssh -i /home/ubuntu/.config/openstack/sunbeam ubuntu@10.20.20.16 ``` That’s it. You’re connected to the instance. You can use regular shell commands to execute various tasks. ``` $ uptime 11:08:36 up 2 min, 1 users, load average: 0.05, 0.05, 0.01 ``` In the [following tutorials](https://ubuntu.com/openstack/tutorials), we’ll demonstrate how to use other images and how to customise instances during the provisioning process. To disconnect from the instance, type `exit` (or press CTRL+D). --- [Suggest changes ›](https://discourse.ubuntu.com/t/install-openstack-and-launch-your-first-instance/25065) about 2 minutes to go [*Previous step*](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#1-overview) [*Next step*](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#3-next-steps) ## 3. Next steps Congratulations! You have reached the end of this tutorial. You can now move to the next tutorial - [“2. Components”](https://ubuntu.com/tutorials/explore-openstack-components-and-set-up-an-openstack-client) - or [explore other tutorials](https://ubuntu.com/openstack/tutorials). ### [In this tutorial, you have learnt how to:](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-in-this-tutorial-you-have-learnt-how-to) * Install OpenStack with Sunbeam * Launch your first instance on OpenStack ### [Where to go from here?](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#p-66351-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/install-openstack-and-launch-your-first-instance/25065) about 0 minutes to go [*Previous step*](https://ubuntu.com/tutorials/install-openstack-on-your-workstation-and-launch-your-first-instance?format=md#2-install-openstack) *Next step*