Comment exécuter un serveur Ampache sur un serveur Ubuntu

Ampache transforme un serveur Ubuntu en une bibliothèque musicale auto-hébergée, accessible via un navigateur ou une application compatible. Ce guide utilise Ubuntu Server 26.04 LTS, Apache, MariaDB et Ampache 8.3.0. Ampache 8 requiert PHP 8.5 ou une version ultérieure ; vérifiez donc la configuration requise avant d'utiliser une version antérieure d'Ubuntu.

Vous aurez besoin d'un compte sudo, d'un espace disque suffisant pour votre musique et d'un nom de domaine si vous souhaitez rendre le serveur accessible sur Internet. Limitez l'installation à un réseau de confiance jusqu'à la fin du processus.

Installer Ampache sur un serveur Ubuntu

1. Installez Apache, MariaDB, PHP et les outils audio.

Mettez à jour Ubuntu et installez les composants serveur et les extensions PHP. Vérifiez qu'Ampache est compatible avec FFmpeg et les utilitaires audio pour le traitement et le transcodage multimédia.

sudo apt update
sudo apt upgrade -y
sudo apt install apache2 mariadb-server php8.5 php8.5-cli php8.5-curl php8.5-gd php8.5-intl php8.5-mbstring php8.5-mysql php8.5-xml php8.5-zip ffmpeg flac lame vorbis-tools inotify-tools zip unzip curl
sudo systemctl enable --now apache2 mariadb

Ubuntu 26.04 inclut PHP 8.5 dans son archive. Si votre serveur propose une version de PHP différente, choisissez une version d'Ampache compatible avec cette version ou suivez le guide spécifique à la version d'Ampache ; ne présumez pas que le phppaquet sans version réponde aux exigences d'Ampache 8.

2. Créez une base de données et un utilisateur dédié

Ouvrez l'interface d'administration locale de MariaDB. Le compte de l'application aura accès uniquement à la base de données d'Ampache, tandis que l'administration locale de MariaDB sous Ubuntu restera distincte.

sudo mariadb

À l'invite MariaDB, créez la base de données et remplacez le mot de passe d'exemple par un mot de passe long et unique. Évitez d'utiliser une apostrophe dans le mot de passe, sauf si vous l'échappez correctement en SQL.

CREATE DATABASE ampache CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ampacheuser'@'localhost' IDENTIFIED BY 'REPLACE_WITH_A_LONG_RANDOM_PASSWORD';
GRANT ALL PRIVILEGES ON ampache.* TO 'ampacheuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3. Téléchargez l'archive de la version Ampache

La page officielle des versions répertorie les archives. L'exemple ci-dessous spécifie Ampache 8.3.0 et sa version PHP 8.5 ; si une version plus récente est disponible lors de votre installation, mettez à jour la version et le nom du fichier.

cd /tmp
wget https://github.com/ampache/ampache/releases/download/8.3.0/ampache-8.3.0_php8.5.zip
sudo mkdir -p /var/www/ampache
sudo unzip ampache-8.3.0_php8.5.zip -d /var/www/ampache
sudo chown -R root:www-data /var/www/ampache
sudo chmod -R g+rX /var/www/ampache
sudo chown www-data:www-data /var/www/ampache/config
sudo chmod 775 /var/www/ampache/config

Lors de l'installation, le serveur web doit créer le répertoire de configuration. Les autres fichiers de l'application peuvent rester la propriété de l'utilisateur root et être accessibles en lecture par Apache.

4. Configurez Apache pour qu'il pointe vers le répertoire public d'Ampache.

Le répertoire racine web d'Ampache est le publicsous-répertoire. Sur un serveur dédié à Ampache, modifiez l'hôte virtuel par défaut ; utilisez un hôte virtuel distinct si Apache héberge déjà d'autres sites.

sudo nano /etc/apache2/sites-available/000-default.conf

Dans le <VirtualHost *:80>bloc existant, définissez le nom de votre serveur et le répertoire racine, puis ajoutez les règles de répertoire :

ServerName ampache.example.com
DocumentRoot /var/www/ampache/public

<Directory /var/www/ampache/public>
    AllowOverride All
    Require all granted
</Directory>

Activez la réécriture Apache, générez les fichiers de réécriture fournis par Apache, testez la configuration et rechargez Apache :

sudo a2enmod rewrite
cd /var/www/ampache
sudo php bin/installer htaccess -e -p
sudo apache2ctl configtest
sudo systemctl reload apache2

Ce AllowOverride Allparamètre permet à Apache de lire ces fichiers. Ampache avertit que le streaming et ses API peuvent renvoyer des erreurs 404 lorsque la réécriture d'URL est indisponible ; consultez son guide des règles de réécriture si vous utilisez un hôte virtuel personnalisé.

5. Vérifiez le serveur dans l'installateur d'Ampache.

Depuis un ordinateur de votre réseau de confiance, ouvrez le fichier http://ampache.example.com/install.php. Si vous n'avez pas configuré le DNS, utilisez l'adresse IP privée du serveur. Choisissez une langue, sélectionnez « Démarrer la configuration » et consultez la page des prérequis. Installez tous les modules PHP manquants avant de continuer ; installez le php8.5-paquet correspondant et redémarrez Apache si nécessaire.

6. Connectez-vous à la base de données et rédigez la configuration.

Saisissez localhostl'hôte de la base de données, ampachele nom de la base de données et les ampacheuseridentifiants créés précédemment. Utilisez ce compte dédié plutôt que le compte racine de MariaDB. Sélectionnez le type d'installation standard. Si vous souhaitez qu'Ampache transcode l'audio, choisissez FFmpeg dans les options de transcodage ; sinon, laissez le transcodage désactivé. Cliquez sur « Créer une configuration » pour enregistrer le fichier de configuration.

7. Créez le compte administrateur Ampache

Créez un nom d'utilisateur et un mot de passe robustes pour l'administrateur Ampache. Ce compte vous permettra de gérer la musique et les utilisateurs dans Ampache ; il est distinct de votre compte Ubuntu et de votre compte MariaDB. Laissez l'installateur appliquer les mises à jour de la base de données, puis connectez-vous.

8. Ajoutez votre musique en tant que catalogue

Rendez le dossier musical accessible par Apache. Utilisez le chemin d'accès où se trouvent réellement vos fichiers ; l'exemple crée un nouveau répertoire de bibliothèque :

sudo mkdir -p /srv/music
sudo chgrp -R www-data /srv/music
sudo chmod -R g+rX /srv/music

Copiez ou montez vos pistes à cet emplacement, puis connectez-vous en tant qu'administrateur Ampache. Ouvrez le menu Admin et sélectionnez Ajouter un catalogue . Saisissez un nom, par exemple « Catalogue » Music, indiquez le chemin complet /srv/music, choisissez un catalogue musical local et ajoutez-le. Lancez une mise à jour pour qu'Ampache prenne en compte les fichiers. Le guide du catalogue explique sa gestion et les permissions.

Sécurisez l'accès à distance et maintenez la bibliothèque à jour.

Pour qu'un serveur soit accessible depuis Internet, configurez l'enregistrement DNS de votre domaine pour qu'il pointe vers ce serveur et activez le protocole HTTPS avant de communiquer son adresse. Le guide Ubuntu d'Ampache utilise Certbot avec Apache.

sudo apt install snapd
sudo snap install certbot --classic
sudo certbot --apache -d ampache.example.com

Une fois le certificat installé, configurez force_ssl = "true"Ampache /var/www/ampache/config/ampache.cfg.phppour qu'il génère des liens HTTPS. Dans UFW, autorisez le port SSH du serveur avant d'activer le pare-feu, puis autorisez le trafic web sur les ports 80 et 443. Fermez le port 3306 de MariaDB à l'accès public à Internet. La documentation du pare-feu d'Ubuntu détaille les règles UFW.

Si l'analyse musicale ne donne aucun résultat, vérifiez que le chemin d'accès au catalogue est correct et que le compte dispose des droits de lecture et d'accès aux répertoires. Pour les actualisations régulières du catalogue et autres tâches planifiées, configurez les tâches cronwww-data d'Ampache .