Skip to content
VM2Cloud Docs

Managed OpenStack quickstart

This guide takes you from a new VM2Cloud Managed OpenStack tenancy to a running instance. It assumes you have received your tenancy details from the VM2Cloud onboarding team (get in touch).

1. Access your tenancy

Section titled “1. Access your tenancy”

After onboarding you receive:

  • A web dashboard URL for your region — a browser-based console, with nothing to install.
  • A project (tenant) name and your user credentials.
  • An openrc file containing the API endpoints and auth environment variables for the CLI.

2. Install the CLI

Section titled “2. Install the CLI”
Terminal window
python3 -m pip install python-openstackclient

3. Authenticate

Section titled “3. Authenticate”

Source the openrc file and confirm access:

Terminal window
source ./vm2cloud-openrc.sh   # prompts for your password
openstack token issue         # confirms authentication
openstack catalog list        # lists the services in your region

4. Launch your first instance

Section titled “4. Launch your first instance”
Terminal window
# Pick an image and a flavor (size)
openstack image list
openstack flavor list


# Create an instance on your project network
openstack server create \
  --image "Ubuntu 24.04 LTS" \
  --flavor v2.medium \
  --network default \
  --key-name my-key \
  my-first-instance


openstack server list

Next steps

Section titled “Next steps”