Owncloud ligne de commande

modifié le : 13 septembre 2022,
par Guillaume Chéramy
 

Nous allons voir comment, en ligne de commande nous pouvons administrer une instance Owncloud. Le projet owncloud fourni pour cela la commande occ.


Lancer la commande

Une première chose est de se trouver dans le répertoire de l'installation d'owncloud. Par exemple : /var/www/owncloud/www
De plus c'est une commande php donc il faut l'exécuter comme ceci :

# php occConsole has to be executed with the user that owns the file config/config.php
Current user: root
Owner of config.php: demo

Et donc il faut l'exécuter sous l'utilisateur possédant le fichier config/config.php dans mon cas l'utilisateur demo.

On arrive donc à ceci :

# cd /var/www/owncloud/www
#sudo -u demo php occ

Ce qui nous liste toutes les commandes disponibles

 

Donc par exemple pour obtenir le status de notre installation owncloud :


# sudo -u demo php occ status
 - installed: true
 - version: 8.1.3.0
 - versionstring: 8.1.3
 - edition:

 

Pour passer l'instance d'owncloud en maintenance :

# sudo -u demo php occ maintenance:mode --on
Maintenance mode enabled

 

Gestion des applications

Une commande très utile je penses est la gestion des applications avec la commande occ app.

Imaginons que vous avez téléchargé et installé le code d'une nouvelle application dans le répertoire apps.

Le premier réflexe est de lister si l'application est bien prise en compte :

# sudo -u demo php occ app:list
Enabled:
 - activity: 2.0.2
 - calendar: 0.7.3
 - contacts: 0.4.0.0
 - documents: 0.10.2
 - encryption: 1.0.0
 - files: 1.1.10
 - files_locking: 
 - files_pdfviewer: 0.7
 - files_sharing: 0.6.2
 - files_texteditor: 0.4
 - files_trashbin: 0.6.3
 - files_versions: 1.0.6
 - firstrunwizard: 1.1
 - gallery: 0.6.0
 - provisioning_api: 0.2
 - tasks: 0.8
 - templateeditor: 0.1
 - updater: 0.6
Disabled:
 - bookmarks
 - external
 - files_external
 - files_videoviewer
 - mail
 - user_external
 - user_ldap
 - user_webdavauth

 

On peut ensuite activer l'application :

# sudo -u demo php occ app:enable mail
mail enabled

 

De même on peut désactiver une application :

# sudo -u demo php occ app:disable mail
mail disabled

 

Gestion des caches de fichiers

On reverra plus tard la gestion des caches mais avec la commande occ files on peut :

Vider le cache

# sudo -u demo php occ files:cleanup
0 orphaned file cache entries deleted

 

Pour scanner les nouveaux fichiers et mettre à jour le cache pour tout le monde :

# sudo -u demo php occ files:scan --all

 

Pour un utilisateur spécifique :

# sudo -u demo php occ files:scan guillaume

 

Gestion des utilisateurs

Lister le nombre d'utilisateurs :

# sudo -u demo php occ user:report
+------------------+----+
| User Report      |    |
+------------------+----+
| Database         | 3  |
| LDAP             | 7  |
|                  |    |
| total users      | 10 |
|                  |    |
| user directories | 6  |
+------------------+----+

 

Ajouter un utilisateur :

# sudo -u demo php occ user:add --display-name="Mathieu" --group="test" mathieu 
Enter password: 
Confirm password: 
The user "mathieu" was created successfully
Display name set to "Mathieu"
User "mathieu" added to group "test"

 

Changer un mot de passe :

# sudo -u demo php occ user:resetpassword mathieu
Warning: Resetting the password when using encryption will result in data loss!
Do you want to continue?y
Enter a new password: 
Confirm the new password: 
Successfully reset password for mathieu

On verra plus tard le pourquoi de l'alerte sur l'encryptage.

 

Commandes ldap

Si le backend ldap est activé.

Voir la config ldap :

# sudo -u demo php occ ldap:show-config

Chercher les utilisateurs dont le nom commence par gui

# sudo -u demo php occ ldap:search gui
Guillaume Chéramy (guillaume.cheramy@************)

 

Il existe d'autres commandes utiles, voir la doc officielle. On verra dans un prochain article comme scripter notre installation.