Installer ownCloud Infinite Scale avec Docker Compose

Pour installer un serveur, commencez par l'exemple Docker Compose officiel d'ownCloud, ocis_fullbasé sur la documentation de la version stable 8.2. Cet exemple inclut le service Infinite Scale, un proxy inverse et des services de collaboration optionnels. Configurez vos domaines, votre serveur SMTP et vos chemins de données dans le .envfichier de configuration avant l'exécution docker compose up -d. Cette configuration est conçue pour une instance unique et nécessite un DNS public et des ports accessibles pour les certificats Let's Encrypt de confiance. Pour une évaluation interne sans domaine, respectez la limitation relative aux certificats auto-signés décrite ci-dessous.

Avant d'installer

Cette procédure suit le guide de production Compose d'ownCloud pour Infinite Scale 8.2 , consulté le 9 octobre 2026. Ce guide est destiné aux systèmes Ubuntu LTS 24.04 ou 22.04 avec Docker Engine et Docker Compose déjà installés. Il recommande au minimum 4 à 6 Go de mémoire vive. Les services activés par défaut nécessitent environ 2,4 Go d'espace disque, avant prise en compte des fichiers utilisateur, des journaux, des sauvegardes et de la croissance future.

Choisissez cet exemple complet si vous pouvez gérer le DNS, les règles de pare-feu et un hôte Linux. Il inclut plus que la plateforme de fichiers de base ; pour une évaluation sans domaine, ownCloud indique que la configuration utilise des certificats auto-signés.

• Hôte : Ubuntu 24.04 LTS ou 22.04 LTS avec accès SSH et sudo.
• Réseau : un domaine dont les enregistrements DNS requis se résolvent en l'adresse WAN du serveur ; autoriser les ports TCP entrants 22, 80 et 443 dans le pare-feu et tout routeur en amont.
• Logiciels : Docker Engine et le plugin Compose. Sous Linux, Docker documente l’installation via son dépôt de paquets ; après l’installation, vérifiez que Compose répond correctement docker compose version.
• Courriel : une valeur SMTP_SENDERest requise pour démarrer cet exemple. Complétez les autres paramètres SMTP si vous souhaitez recevoir des notifications par courriel.

1. Installez Docker Compose et préparez l'hôte.

Si Docker Engine est déjà installé, installez le plugin Compose en suivant la méthode correspondant à votre distribution Linux, comme indiqué dans les instructions d'installation officielles de Docker Compose . Pour les systèmes Ubuntu ou Debian où le dépôt Docker est configuré, la commande d'installation documentée est :

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Docker recommande l'utilisation du plugin et de la docker composeligne de commande pour les installations actuelles. Installez Docker Engine en suivant les instructions officielles pour Ubuntu si nécessaire.

Avant de télécharger la configuration, associez le domaine ou les sous-domaines que vous prévoyez d'utiliser à l'adresse IP publique de l'hôte. L'exemple d'ownCloud requiertOCIS_DOMAIN ; il peut également utiliser COLLABORA_DOMAINet ONLYOFFICE_DOMAINlorsque ces services bureautiques sont configurés. Les noms DNS doivent correspondre aux valeurs de .env. Vérifiez que votre routeur redirige les ports 80 et 443 vers cet hôte et que votre pare-feu local les autorise.

2. Obtenez l'exemple officiel de Compose

Utilisez le ocis_fullrépertoire de la stable-8.2branche des exemples de déploiement officiels d'ownCloud . Téléchargez le fichier ZIP sur un ordinateur équipé d'un navigateur, transférez-le sur le serveur sans interface graphique scpet extrayez-le /opt/compose/ocis/ocis_fullcomme indiqué dans le guide ownCloud.

Enregistrez la version actuelle .envavant d'en extraire une copie mise à jour : ownCloud vous avertit que le fichier peut être écrasé. Exécutez les commandes Compose depuis le répertoire du projet.

3. Configurer les domaines, les certificats, les adresses e-mail et les chemins de données

Ouvrez le fichier /opt/compose/ocis/ocis_full/.envdans un éditeur de texte. Conservez les noms de variables et la syntaxe de l'exemple, et modifiez uniquement les valeurs qui s'appliquent à votre installation :

• Indiquez OCIS_DOMAINle nom d'hôte que les utilisateurs saisiront. Ne spécifiez les noms d'hôte Collabora ou OnlyOffice que si ces services sont activés dans l'exemple.
• Pour un serveur exposé à Internet, commentez les lignes INSECUREcorrespondantes dans l'exemple. Ne laissez pas son paramètre de sécurité activé pour une utilisation publique.
• Indiquez TRAEFIK_ACME_MAILune adresse e-mail dont vous êtes responsable. Pour les tests initiaux de certificat, utilisez TRAEFIK_ACME_CASERVERle serveur de test de Let's Encrypt. Les certificats de test ne sont pas destinés à un usage courant ; ils permettent de tester la configuration DNS et l'accessibilité avant de demander les certificats de production.
• Configurez ces paramètres SMTP_SENDER, même si vous n'avez pas encore de relais de messagerie fonctionnel. Le guide officiel indique que le déploiement ne démarrera pas sans cela. Ajoutez l'hôte SMTP, le port, les identifiants, l'authentification et les paramètres de sécurité lorsqu'ils sont disponibles ; sans ces paramètres, l'instance peut démarrer, mais ne pourra pas envoyer de notifications.
• Veuillez vérifier OCIS_DOCKER_IMAGEles balises d'image dans l'exemple. Ne changez pas de canal de distribution sans raison valable lors de l'installation d'une version stable.
• Pour un serveur de production, il est recommandé d'attribuer OCIS_DATA_DIRles OCIS_CONFIG_DIRchemins d'accès hôtes planifiés à un stockage disposant d'une capacité suffisante et d'une couverture de sauvegarde adéquate. Par défaut, les volumes gérés par Docker sont utilisés, ce qui est pratique, mais ownCloud précise que leur emplacement, les instantanés, la sauvegarde, la restauration, la réinitialisation et la migration dépendent du stockage de l'hôte Docker.

Limitez l'accès au serveur et à son fichier de configuration. Un certificat auto-signé convient uniquement à une évaluation interne et non à un déploiement public sécurisé.

Depuis le répertoire du projet, validez la configuration fusionnée avant de démarrer les conteneurs :

cd /opt/compose/ocis/ocis_full
docker compose config

Corrigez les erreurs de variables ou de YAML signalées avant de continuer. Cette commande affiche la configuration Compose pour inspection ; elle ne garantit pas le bon fonctionnement du DNS, des certificats, des autorisations de stockage ou de la connectivité SMTP.

4. Démarrez les services et terminez la configuration du certificat.

Démarrez la pile en arrière-plan :

docker compose up -d

Le premier lancement télécharge les images et démarre les services ; il peut donc prendre plus de temps que les redémarrages suivants. Vérifiez l’état du service avec :

docker compose ps -a

Ensuite, consultez les journaux si un service s'arrête ou si l'adresse Web ne se charge pas :

docker compose logs --follow

Commencez par consulter les journaux de Traefik. Les erreurs de certificat indiquent généralement une incohérence entre les DNS et .envleurs valeurs, le blocage des ports 80/443 ou une adresse e-mail ACME invalide. Corrigez le problème avant de réessayer. N'utilisez pas docker compose down -vcette fonction pour réinitialiser le projet : elle supprime tous les volumes, y compris les données.

Une fois les vérifications du certificat de préproduction réussies, suivez la procédure de certificat d'ownCloud : arrêtez le déploiement, supprimez uniquement le volume de certificat de l'exemple ( ocis_full_certs), effacez le paramètre d'autorité de certification de préproduction, puis recommencez pour demander des certificats de production approuvés. Vérifiez le nom exact du volume docker volume lsavant de le supprimer. Ne supprimez pas les volumes de données ni de configuration.

Vérifier l'accès et protéger le déploiement

Ouvrez l'URL définie OCIS_DOMAIN. Une connexion réussie signifie que le navigateur accède à la page de connexion via HTTPS sans avertissement de certificat et docker compose ps -aque les services requis sont en cours d'exécution. Connectez-vous à l'aide des identifiants initiaux fournis par ownCloud ( admin/ admin, sauf si vous avez défini un autre mot de passe initial), puis modifiez rapidement le mot de passe administrateur.

Si le site est inaccessible, vérifiez le DNS, la redirection de ports, les journaux ACME de Traefik, puis les journaux du service Infinite Scale. Si la connexion fonctionne mais que les notifications par e-mail ne sont pas reçues, vérifiez les paramètres SMTP.

Avant de stocker des fichiers importants, assurez-vous que votre sauvegarde couvre à la fois la configuration et les données. Les volumes gérés par Docker sont pratiques pour l'évaluation ; les chemins d'accès explicites aux hôtes sont plus faciles à placer sur un disque séparé et à inclure dans les sauvegardes des hôtes. Vous êtes prêt lorsque le protocole HTTPS est valide, que les services restent opérationnels après un redémarrage, que la connexion administrateur fonctionne et que les sauvegardes couvrent le stockage choisi.