Introduction
============

ucloud is a modern, IPv6 first virtual machine management system.
It is an alternative to `OpenNebula <https://opennebula.org/>`_,
`OpenStack <https://www.openstack.org/>`_ or
`Cloudstack <https://cloudstack.apache.org/>`_.

ucloud is the first cloud management system that puts IPv6
first. ucloud also has an integral ordering process that we missed in
existing solutions.

The ucloud documentation is separated into various sections for the
different use cases:

* :ref:`The user guide <user-guide>` describes how to use an existing
  ucloud installation
* There are :ref:`setup instructions <setup-install>` which describe on how to setup a new
  ucloud instance
* :ref:`The admin guide <admin-guide>` describe on how to
  administrate ucloud


Architecture
------------



suuuuuuubsub
^^^^^^^^^^^^

and following a

para
""""

para2?

para2!
""""""
mo moo!

Introduction

What is ucloud?
~~~~~~~~~~~~~~~



Tech Stack
----------
* Python 3 as main language.
* Flask for APIs.
* JSON for specifications.
* QEMU (+ kvm acceleration) as hypervisor.
* etcd for key/value storage (specifically all metadata e.g Virtual Machine Specifications, Networks Specifications, Images Specifications etc.).
* CEPH for image storage.
* uotp for user authentication.
* netbox for IPAM.
* radvd for Router Advertisement.


Components
----------
* API
* Scheduler
* Host
* File Scanner
* Image Scanner
* Metadata Server
* VM Init Scripts (dubbed as ucloud-init)How does ucloud work?
=====================

ucloud is separeted into 3 systems:

1. The client side for using ucloud
2. The server side
3. The supporting infrastructure (databases, virtualisation, etc.)


Depending on your use case, select one of the following guides to
continue:

* I want to use
* I want to operate/run ucloud as a service


Architecture
------------
Description of the ucloud architecture


Authentication
~~~~~~~~~~~~~~