Adapt install scripts and Core to Debian 13 #3176

TiTidom-RC · 2026-01-02T10:46:55Z

Description

Adapt the install scripts and some core functions to ensure Jeedom can be installed on Debian 13, while maintaining backward compatibility with Debian 11 and 12.

Updated the Docker installation files and scripts too.

Suggested changelog entry

All changes are detailed in the _trixie_migrationcheck.md and _trixie_retrocheck.md files. These files are located at the root of the repository.

In summary, here are the key changes :

Replaced Debian Packages :

ntp → chrony
ntpdate → removed (included in chrony)
locate → plocate (modern version with alternative)
espeak + mbrola → espeak-ng
libcurl3-gnutls → libcurl4 (for Debian 13+)

Removed Debian packages :

telnet
apt-transport-https (inluded by default since Debian 10)
cutycapt
dos2unix (replaced by "sed")
libav-tools (replaced by "ffmpeg")
software-properties-common (Ubuntu package, not available in Debian)

Migrate to PHP-FPM :

proxy_fcgi
setenvif

Update MariaDB parameters :

Removed parameters (deprecated) :

query_cache_type, query_cache_size, query_cache_limit, query_cache_min_res_unit (query cache no more available)
innodb_large_prefix (active by default)

Support for custom fork repository (for the install script) :

Add "-r" parameter (R like repository) in install's script :

sudo ./install.sh -r owner/repo -v branche

Updated all references from 'apt' to 'apt-get', adding options to handle conflicts and interactions with shell.

Related issues/external references

Fixes #

Types of changes

Bug fix (non-breaking change which fixes)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)
- This change is only breaking for integrators, not for external standards or end-users.
Documentation improvement

PR checklist

I have checked there is no other PR open for the same change.
I have read the [La ligne directrice pour contribuer à ce projet / Contribution guidelines for this project).
I grant the project the right to include and distribute the code under the GNU.
I have added tests to cover my changes.
I have verified that the code complies with the projects coding standards.
[Required for new sniffs] I have added MD documentation for the sniff.

Update code to be able to install on Debian 13

Avoid error messages (operation not permitted on chmod) after install

zoic21

Beaucoup de changement que je ne comprends pas vraiment

zoic21 · 2026-01-30T10:13:24Z

core/ajax/jeedom.ajax.php

 			$cmd = "set -x\n";
 			$cmd .= system::checkInstallationLog();
-			$cmd .= system::getCmdSudo() . " apt update\n";
+			$cmd .= system::getCmdSudo() . " apt-get update\n";


Pourquoi revenir sur l'ancienne syntaxe apt ?

"apt" est prévu pour une utilisation "interactive" (par des humains) sous Linux, et "apt-get" est la version préconisée pour le mode "script", outil plus prédictible, sans barre de progression, sans message interactif etc..., C'est pour cela que je l'ai utilisé ici.

De mes connaissances, ce n'est pas une "ancienne syntaxe" (même s'il est plus ancien que "apt" il est vrai), mais une syntaxe orientée scripting.

Cela permet également d'éviter les messages de type WARNING: apt does not have a stable CLI interface. Use with caution in scripts.

zoic21 · 2026-01-30T10:13:52Z

core/class/cache.class.php

 		if (!file_exists(__DIR__ . '/../../cache.tar.gz')) {
-			$cmd = 'mkdir ' . $cache_dir . ';';
-			$cmd .= 'chmod -R 777 ' . $cache_dir . ';';
+			$cmd = system::getCmdSudo() . 'mkdir -p ' . $cache_dir . ';';


Normalement tout le cache est sous www-data avec ce changement il passe en root ce qui n'est pas top

Effectivement, le sudo mkdir va créer le dossier en root, mais aux lignes 402 et 403 (juste en dessous) je gère le owner du dossier en le réattribuant à "www-data" (user et groupe d'ailleurs).

J'ai utilisé le "sudo" par "sécurité", au cas où il y aurait des problèmes de droits existants sur le répertoire parent, et j'ai surtout utilisé le paramètre "-p" pour créer l'arborescence si elle n'existe pas.

Par les lignes d'en dessous, je m'assure que le répertoire appartient bien à "www-data" et ainsi ne pas gêner Jeedom dans son fonctionnement.

zoic21 · 2026-01-30T10:14:44Z

install/OS_specific/Docker/init.sh

+echo "ServerName localhost" >> /etc/apache2/apache2.conf
+
+echo 'Start PHP-FPM'
+PHP_VERSION=$(php -r "echo PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION;")


Je veux bien plus de détails la dessus

oui bien sûr.

J'ai basculé le script d'install pour utiliser le module PHP "FPM" couplé à "mod_proxy_fcgi" côté Apache. A l'install, le paquet linux "fpm" n'a pas d'appellation / alias "générique" sous Linux, mais est du style "php8.3-fpm" (donc contient la version php dans son nom). Pour que le script d'init reste valide pour n'importe quelle version qui sera installée maintenant mais également à l'avenir, je le passe en mode dynamique, en calculant la version PHP qui est installée, et en appelant donc le service "fpm" correspondant (ligne 157).

Si la question était pour le fait de démarrer le service, le module fpm ne démarre pas tout seul après son install, et dans un docker, il n'y a pas systématiquement de "systemd", donc je force le démarrage du service (ligne 157) avec son nom complet (incluant donc la version de PHP).

zoic21 · 2026-01-30T10:15:30Z

install/OS_specific/Docker/init_workflow.sh

 elif [[ "${GITHUB_REF_NAME}" == "beta" ]]; then
  JEEDOM_TAGS="${REPO}/jeedom:beta"; # ${REPO}/jeedom:$JEEDOM_SHORT_VERSION";
  GITHUB_BRANCH=${GITHUB_REF_NAME};
+elif [[ "${GITHUB_REF_NAME}" == "trixie" ]]; then


Pour moi on devrait pas avoir une branche trixie....

dans le principe, je suis tout à fait d'accord avec toi, mais il me fallait bien le moyen de tester le script d'install de bout en bout, et la branche "trixie" était son nom actuel 👍

De la même manière, j'imagine qu'à terme, les lignes 19 et 20 (parlant de la branche alpha) devraient disparaitre également, non ?

zoic21 · 2026-01-30T10:16:23Z

install/install.sh

    echo "thread_cache_size = 16" >> /etc/mysql/conf.d/jeedom_my.cnf
    echo "tmp_table_size = 48M" >> /etc/mysql/conf.d/jeedom_my.cnf
    echo "max_heap_table_size = 48M" >> /etc/mysql/conf.d/jeedom_my.cnf
-    echo "query_cache_type =1" >> /etc/mysql/conf.d/jeedom_my.cnf


Pourquoi toute ces suppressions ?

je comprend que cela puisse surprendre. Sous Debian 13, lors de mes premiers tests j'avais des messages d'erreurs concernant "innodb_large_prefix", qui (je l'ai appris à cette occasion) est dépécié depuis MariaDB 10.3.

Du coup j'ai approfondi mes recherches, et concernant le "Query Cache", il est mal optimisé pour des architectures processeurs récentes, et est désactivé ou déprécié par défaut depuis plusieurs versions de MariaDB (incluant celles sous les OS Debian 11, 12, 13, et paramètre supprimé de MySQL 8) et il est donc conseillé de ne plus forcer ces valeurs.

TiTidom-RC added 30 commits January 2, 2026 11:27

Compatibility with Trixie

212ab3c

Update code to be able to install on Debian 13

update install script

e370e00

update install script

bc44601

Update install.sh

e897d01

update install script + doc trixie

8147877

update install script

89b7e11

Update script install_nodejs

5c561ae

update nodejs install script

f819608

update trixie migrate doc

5baf50c

Update install_nodejs.sh

110d3ba

Update install_nodejs.sh

af36ea8

Update install script

bd7e970

Update system.class.php

f26e334

change apt to apt-get

34f4b0b

update _trixie MD

8c2dd52

update interactions in install script

56cc81f

update _trixie MD

c1ea0d6

update shell interactions in install script

39f9585

update install_openssl.sh

66d7515

update wget options in install scripts

c3737dc

update wget options to redirect logs to stdout

9404ebc

Merge remote-tracking branch 'upstream/master' into trixie

680428e

Merge remote-tracking branch 'upstream/4.5.2' into trixie

19e18b9

update _trixie docs

5e74a14

add apt clean in install script

ed8316e

Update Dockerfile for Debian 13

ccf252b

add trixie tag for docker

5d05077

include GITHUB_REPO var in init.sh

5084f90

Update _trixie_migrationcheck.md

f366727

Update Dockerfile

5f6c888

TiTidom-RC added 12 commits January 2, 2026 11:29

Update Dockerfile

d2873ef

Update init.sh

84ec09c

typo in init_workflow.sh

161393c

Update _trixie_migrationcheck.md

1133845

Update _trixie_migrationcheck.md

48fc559

Update _trixie_migrationcheck.md

6d37ed4

Update _trixie_migrationcheck.md

17906a2

Update cache restore function

2a3352a

Avoid error messages (operation not permitted on chmod) after install

Update _trixie_migrationcheck.md

6dc357d

Update init.sh

9299e48

Merge branch 'trixie' into trixie

b8bf6f1

add mariadb-client-compat to the install scripts

3708eec

zoic21 requested changes Jan 30, 2026

View reviewed changes

zoic21 added the Need review label Jan 30, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Adapt install scripts and Core to Debian 13 #3176

Adapt install scripts and Core to Debian 13 #3176

TiTidom-RC commented Jan 2, 2026

Uh oh!

zoic21 left a comment

Uh oh!

zoic21 Jan 30, 2026

Uh oh!

TiTidom-RC Jan 30, 2026

Uh oh!

zoic21 Jan 30, 2026

Uh oh!

TiTidom-RC Jan 30, 2026

Uh oh!

zoic21 Jan 30, 2026

Uh oh!

TiTidom-RC Jan 30, 2026

Uh oh!

zoic21 Jan 30, 2026

Uh oh!

TiTidom-RC Jan 30, 2026

Uh oh!

zoic21 Jan 30, 2026

Uh oh!

TiTidom-RC Jan 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Adapt install scripts and Core to Debian 13 #3176

Are you sure you want to change the base?

Adapt install scripts and Core to Debian 13 #3176

Conversation

TiTidom-RC commented Jan 2, 2026

Description

Suggested changelog entry

Related issues/external references

Types of changes

PR checklist

Uh oh!

zoic21 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants