.. _home:

Canonical OpenStack documentation
==================================

`Canonical OpenStack <https://canonical.com/openstack>`_ is an enterprise-grade cloud platform that delivers
distilled upstream OpenStack excellence in the form of a human-friendly
product.

Canonical OpenStack provides elastic and on-demand compute, network and storage
resources to serve IT and business computing needs through a self-service
portal or pure upstream OpenStack APIs. It allows for the simplicity and the
power of public cloud workflows in cost-effective and sovereign, on-premise
environments.

Backed by `Sunbeam <https://governance.openstack.org/tc/reference/projects/sunbeam.html>`_, Canonical OpenStack uses fully cloud-native architecture
underneath to isolate individual components from each other and fully decouple
the software from the underlying OS. In the background the product uses
various technologies, open-source projects and other Canonical products that
are required to form an end-to-end cloud solution.

Sunbeam is an upstream OpenStack project hosted under the governance of the
OpenInfra Foundation which aims to lower the barrier to entry for people with
no previous OpenStack background and fully revolutionize the operational
experience.

---------

.. rubric:: :h2:`In this documentation`

..  grid:: 1 1 2 2

   ..  grid-item:: :doc:`Tutorials <tutorial/index>`

       **Start here**: a hands-on introduction to Canonical OpenStack for new users

   ..  grid-item:: :doc:`How-to guides <how-to/index>`

      **Step-by-step guides** covering key operations and common tasks

.. grid:: 1 1 2 2
   :reverse:

   .. grid-item:: :doc:`Reference <reference/index>`

      **Technical information** - specifications, APIs, architecture

   .. grid-item:: :doc:`Explanation <explanation/index>`

      **Discussion and clarification** of key topics

---------

.. rubric:: :h2:`Community and commercial usage`

Canonical OpenStack is based on Sunbeam - an open source project that warmly
welcomes a free-of-charge usage, constructive feedback, community discussions
and especially contributions.

Click on the following links to engage with the OpenStack engineering team at
Canonical:

* `Report a bug <https://bugs.launchpad.net/snap-openstack/+filebug>`_
* `Join the community chat <https://matrix.to/#/#openstack-sunbeam:ubuntu.com>`_
* `Contribute to the project <https://github.com/canonical/snap-openstack>`_

For a commercial usage, consider visiting the following links instead:

* `Explore Canonical OpenStack <https://canonical.com/openstack>`_
* `Get Ubuntu Pro subscription for your deployment <https://ubuntu.com/pro/subscribe>`_
* `Get in touch with Canonical cloud experts for help on your on-going cloud project <https://canonical.com/openstack#get-in-touch>`_

.. toctree::
   :hidden:
   :maxdepth: 2

   tutorial/index
   how-to/index
   reference/index
   explanation/index