.. _tutorial_index:

Tutorials
*********

This section contains step-by-step tutorials to help you get started with
``cloud-init``. We hope our tutorials make as few assumptions as possible and
are accessible to anyone with an interest in ``cloud-init``. They should be a
great place to start learning about ``cloud-init``, how it works, and what it's
capable of.

-----

Core tutorial
=============

This tutorial, which we recommend if you are completely new to ``cloud-init``,
uses the QEMU emulator to introduce you to all of the key concepts, tools,
processes and operations that you will need to get started.

.. toctree::
   :maxdepth: 1

   qemu.rst

Quick-start tutorial
====================

This tutorial is recommended if you have some familiarity with ``cloud-init``
or the concepts around it, and are looking to get started as quickly as
possible. Here, you will use an LXD container to deploy a ``cloud-init``
user data script.

.. toctree::
   :maxdepth: 1

   lxd.rst

WSL tutorial
============

This tutorial is for learning to use ``cloud-init`` within a ``WSL``
environment. You will use a ``cloud-init`` user data script to customize a
``WSL`` instance.

.. toctree::
   :maxdepth: 1

   wsl.rst
