Proxmox
=======

We're running our own `Proxmox VE <https://www.proxmox.com/en/>`_ servers to virtualise all of our :ref:`Linux` servers.

Access Proxmox
--------------

To access Proxmox, use on of the following methods:

- Use the Proxmox SSH link in the :ref:`Dashboard`
- Use the Proxmox web UI link in the :ref:`Dashboard`

Proxmox & Ansible
-----------------

Proxmox is configured, and managed via :ref:`Ansible`, resp. :ref:`Semaphore`. 

.. hint::

    While Proxmox is a Debian-based solution, the «standard Linux roles» are applied. However, Proxmox-specific settings are applied via the `proxmox playbook <https://gitlab.confirm.ch/confirm/infrastructure/ansible/projects/confirm/-/blob/main/playbooks/config_proxmox.yml>`_, resp. the `proxmox role <https://gitlab.confirm.ch/confirm/infrastructure/ansible/projects/confirm/-/tree/main/roles/proxmox>`_.

Manage virtual machines
-----------------------

To manage virutal machines, you've to :ref:`access Proxmox <Access Proxmox>`.
Then use one of the following methods:

1. The Proxmox web UI
2. The ``qm`` `CLI utility <https://pve.proxmox.com/pve-docs/qm.1.html>`_

.. important::

    The VM management is mostly automated via :ref:`Ansible`, resp. the `proxmox VM role <https://gitlab.confirm.ch/confirm/infrastructure/ansible/-/tree/main/roles/proxmox_vm>`_ which is leveraged by all the ``vm_*`` playbooks. You shouldn't manually create, update, modify, or delete virtual machines.

    Read the `VM documentation <https://gitlab.confirm.ch/confirm/infrastructure/ansible/projects/confirm/-/blob/main/VMs.md>`_ in the :ref:`Ansible` project for more information.

Fresh Proxmox install
---------------------

Check out the `proxmox README <https://gitlab.confirm.ch/confirm/infrastructure/ansible/projects/confirm/-/blob/main/roles/proxmox/README.md>`_ to see how Proxmox is setup from scratch.