====== Installation Xen Orchestra à partir des sources ======


== Sources ==

[[https://docs.xen-orchestra.com/installation]]


== Installation ==
Installation sur une debian 13

  * installation des paquets requis
<code bash>
root@xoa:~# apt-get install build-essential redis-server libpng-dev git python3-minimal libvhdi-utils lvm2 cifs-utils nfs-common ntfs-3g openssl libfuse2 nmap wget npm htop tree
</code>


  * installation de yarn
<code bash>
root@xoa:~# npm install -g yarn
</code>

  * test de REDIS
<code bash>
root@xoa:~# systemctl restart redis.service
root@xoa:~# redis-cli ping
PONG
</code>

  * installation de Xen Orchestra
<code bash>
root@xoa:~# git clone -b master https://github.com/vatesfr/xen-orchestra
root@xoa:~# cd xen-orchestra
root@xoa:~# yarn
root@xoa:~# yarn build
root@xoa:~# cd packages/xo-server
</code>


  * création du fichier de conf
<code bash>
root@xoa:~# mkdir -p /etc/xo-server/
root@xoa:~# cp sample.config.toml /etc/xo-server/config.toml


In this config file, you can change default ports (80 and 443) for xo-server. If you are running the server as a non-root user, you will need to set the port to 1024 or higher.
ici nous le faisons tourner sur le 8080

root@xoa:~# vi /etc/xo-server/config.toml

[[http.listen]]
[...]
port = 8080
[...]

</code>



  * démarrage du service
<code bash>
root@xoa:~# yarn start

Default user: "admin@admin.net" with password "admin"
</code>


== Démarrage automatique ==

Le daemon tournant sur le port 8080, nous pouvons le lancer en utilisateur non-root.


  * création du user xen-orchestra
<code bash>
root@xoa:~# useradd -m xen-orchestra   -d /home/xen-orchestra
</code>


  * déplacement des binaires et ajustement des droits des binaires et du répertoire des données persistantes
<code bash>
root@xoa:~# mv /root/xen-orchestra/ /usr/bin/
root@xoa:~# chown xen-orchestra:xen-orchestra /usr/bin/xen-orchestra/ -R
root@xoa:~# chown xen-orchestra:xen-orchestra  /var/lib/xo-server/ -R
</code>


  * création du service
<code bash>
root@xoa:~# vi /etc/systemd/system/xo-server.service

[Unit]
Description=XO Server
After=network-online.target

[Service]
User=xen-orchestra
Group=xen-orchestra
Environment="DEBUG=xo:main"
Restart=always
SyslogIdentifier=xo-server

# Be sure to edit the path below to where your Node and your xo-server install is located!
ExecStart=/usr/bin/node /usr/bin/xen-orchestra/packages/xo-server/dist/cli.mjs

[Install]
WantedBy=multi-user.target


root@xoa:~# systemctl daemon-reload
root@xoa:~# systemctl enable --now xo-server
Created symlink '/etc/systemd/system/multi-user.target.wants/xo-server.service' → '/etc/systemd/system/xo-server.service'.

</code>


== Gestion de la date et heure ==

Sur Debian, aucun daemon de temps n'est installé par défault

  * installation et configuration de systemd-timesyncd

<code bash>
root@xoa:~# apt install systemd-timesyncd
Installation de :                               
  systemd-timesyncd

Sommaire :
  Mise à niveau de : 0. Installation de : 1Supprimé : 0. Non mis à jour : 0
Taille du téléchargement : 92,9 kB
  Espace nécessaire : 207 kB / 13,1 GB disponible

Réception de : 1 http://ftp.ec-m.fr/debian trixie-updates/main amd64 systemd-timesyncd amd64 257.8-1~deb13u2 [92,9 kB]
92,9 ko réceptionnés en 0s (970 ko/s)        
Sélection du paquet systemd-timesyncd précédemment désélectionné.
(Lecture de la base de données... 77807 fichiers et répertoires déjà installés.)
Préparation du dépaquetage de .../systemd-timesyncd_257.8-1~deb13u2_amd64.deb ...
Dépaquetage de systemd-timesyncd (257.8-1~deb13u2) ...
Paramétrage de systemd-timesyncd (257.8-1~deb13u2) ...
Creating group 'systemd-timesync' with GID 989.
Creating user 'systemd-timesync' (systemd Time Synchronization) with UID 989 and GID 989.
Created symlink '/etc/systemd/system/dbus-org.freedesktop.timesync1.service' → '/usr/lib/systemd/system/systemd-timesyncd.service'.
Created symlink '/etc/systemd/system/sysinit.target.wants/systemd-timesyncd.service' → '/usr/lib/systemd/system/systemd-timesyncd.service'.
systemd-time-wait-sync.service is a disabled or a static unit, not starting it.
Traitement des actions différées (« triggers ») pour dbus (1.16.2-2) ...
</code>


  * ajout des NTP
<code bash>
#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it under the
#  terms of the GNU Lesser General Public License as published by the Free
#  Software Foundation; either version 2.1 of the License, or (at your option)
#  any later version.
#
# Entries in this file show the compile time defaults. Local configuration
# should be created by either modifying this file (or a copy of it placed in
# /etc/ if the original file is shipped in /usr/), or by creating "drop-ins" in
# the /etc/systemd/timesyncd.conf.d/ directory. The latter is generally
# recommended. Defaults can be restored by simply deleting the main
# configuration file and all drop-ins located in /etc/.
#
# Use 'systemd-analyze cat-config systemd/timesyncd.conf' to display the full config.
#
# See timesyncd.conf(5) for details.

[Time]
NTP=0.debian.pool.ntp.org 1.debian.pool.ntp.org 2.debian.pool.ntp.org 3.debian.pool.ntp.org
#FallbackNTP=0.debian.pool.ntp.org 1.debian.pool.ntp.org 2.debian.pool.ntp.org 3.debian.pool.ntp.org
RootDistanceMaxSec=5
PollIntervalMinSec=32
PollIntervalMaxSec=2048
ConnectionRetrySec=30
SaveIntervalSec=60
</code>


  * redémarrage du daemon
<code bash>
root@xoa:~# systemctl restart systemd-timesyncd
</code>

  * forçage en NTP
<code bash>
root@xoa:~# timedatectl set-ntp true
</code>


  * status final
<code bash>
root@xoa:~# timedatectl 
               Local time: dim. 2025-11-09 19:37:30 CET
           Universal time: dim. 2025-11-09 18:37:30 UTC
                 RTC time: dim. 2025-11-09 18:37:30
                Time zone: Europe/Paris (CET, +0100)
System clock synchronized: yes
              NTP service: active
          RTC in local TZ: no

</code>

== Updating ==

If you would like to update your current version, enter your xen-orchestra directory and run the following:

# This will clear any changes you made in the repository!!
git checkout .

git pull --ff-only
yarn
yarn build