Installation sur Ubuntu 22.04

Pré-requis

Python 3.10

Tout d'abord, vérifiez que Python 3.10+ est installé sur votre machine

python3 --version
# Python 3.10.6

Ensuite, installez pip et venv :

sudo apt-get update -y
sudo apt-get install -y python3-pip python3-venv

Git, Redis et wkhtmltopdf

Ensuite, installez les paquets suivants :

# Mise à jour des dépôts
sudo apt-get install -y ca-certificates
sudo apt-get update -y

sudo apt-get install -y git redis-server xvfb libfontconfig wkhtmltopdf

MariaDB (v10.4 à v10.8)

sudo apt-get install -y mariadb-server
sudo apt-get install -y mariadb-client  # optionnel

Dodock nécessite une configuration particulière de MariaDB.
Éditez le fichier de configuration /etc/mysql/my.cnf pour y ajouter les lignes de configuration ci-dessous.

Exemple de commande pour éditer ce fichier:

sudo nano /etc/mysql/my.cnf

Lignes de configuration à ajouter à la fin du fichier

# Dodock Install
[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4

Redémarrer le service mysql

sudo service mysql restart

Pendant l'installation, vous devrez choisir un mot de passe pour l'utilisateur root pour votre base de données. Pour le configurer ou le modifier, vous pouvez lancer la commande suivante :

sudo mariadb-secure-installation
# > Enter current password for root (enter for none):
# Appuyer simplement sur Entrée à la première question.

# > Switch to unix_socket authentication [Y/n]
# Répondre non (n) à la question, car nous utiliserons l'authentification par mot de passe.

# > Set root password? [Y/n]
# Répondre oui (Y), puis entrer un mot de passe sécurisé pour l'utilisateur `root` de la base de données.
# Ce mot de passe sera demandé à chaque création de site, ainsi que lors des opérations de maintenance.

# Ensuite, répondre oui (Y) à toutes les questions suivantes.

Vérifiez que vous pouvez vous connecter à la base de données

mysql -u root -p
# Pour quitter la console, tapez `exit`

NodeJS (v18) et yarn

Vous pouvez installer NodeJS via nvm ou le gestionnaire de paquets de votre distribution.

Par exemple :

curl -o - https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
. "$HOME/.nvm/nvm.sh"
nvm install 18
npm install -g yarn

# Create a symlink to your usr path
sudo ln -s $(which node) /usr/bin/

Vérifiez que NodeJS a bien été installé

node -v
# v18.xx.y

Dokos CLI

Dokos CLI est une ligne de commande, adaptée de Bench, permettant de gérer vos sites et applications Dodock.
Vous pouvez l'installer grâce à pip

export PATH=$PATH:$HOME/.local/bin
python3 -m pip install --upgrade --quiet dokos-cli

Ensuite, vérifiez que Dokos CLI a bien été installée :

bench --version
# 2.5.3

Démarrage du serveur et installation d'un site

Création d'un bench

Un bench est un ensemble de sites et d'applications, et se crée avec les commandes suivantes :

cd  # Retournez dans votre dossier personnel
bench init dokos-bench --version v4
cd dokos-bench

Ensuite, téléchargez les applications que vous souhaitez installer sur vos sites. Nous vous recommandons les applications suivantes pour démarrer, mais beaucoup d'autres applications sont disponibles

# Téléchargez les applications de base
bench get-app --branch v4 payments
bench get-app --branch v4 dokos
bench get-app --branch v4 webshop
bench get-app --branch v4 hrms

Démarrage du serveur

Vérifiez que vous êtes bien dans le bench que vous venez de créez puis lancez les commandes suivantes pour activer le mode production de Dokos.

cd dokos-bench # ici dokos-bench est le nom de votre bench et peut être différent

sudo python3 -m pip install -U -q dokos-cli
sudo -H bench setup production $USER

Création d'un site

Créez votre site et installez les applications dont vous avez besoin.

# Créez un site (remplacez `monsite.dokos.cloud` par le nom de domaine de votre choix)
bench new-site monsite.dokos.cloud

# Installez les applications dont vous avez besoin
bench --site monsite.dokos.cloud install-app payments
bench --site monsite.dokos.cloud install-app dokos
bench --site monsite.dokos.cloud install-app webshop
bench --site monsite.dokos.cloud install-app hrms

Finaliser l'installation

Une fois le site créé, vous pouvez vous connecter et accéder à l'interface d'administration avec l'une des adresses suivantes :

• Si Dokos est installé sur votre ordinateur directement : http://localhost.
• Si vous avez un enregistrement DNS configuré qui pointe vers votre serveur : http://monsite.dokos.cloud.

Utilisez les identifiants suivants :

• Adresse email : Administrator
• Mot de passe : le mot de passe que vous avez choisi lors de la création du site.

Suivez les instructions du « Setup Wizard », l'outil d'installation de Dokos, pour finaliser l'installation.

Pour aller plus loin

Pour le rendre accessible depuis l'extérieur, il faut configurer un enregistrement DNS qui pointe vers votre serveur, et configurer Let's Encrypt pour obtenir un certificat SSL.

Questions Fréquentes

Le site s'affiche sans mise en forme ni couleurs ?

• Vérifiez que votre dossier utilisateur serveur est bien accessible pour Nginx.
• Vous pouvez donner les droits de lecture en lançant chmod +x /home/{votre utilisateur}