computer-playbook/roles/docker-nextcloud/README.md

115 lines
3.7 KiB
Markdown

# role docker-nextcloud
## CLI
### database access
To access the database execute
```bash
docker exec -it nextcloud_database_1 mysql -u nextcloud -p
```
### update
To update the nextcloud container execute the following commands on the server:
```bash
export COMPOSE_HTTP_TIMEOUT=600
export DOCKER_CLIENT_TIMEOUT=600
cd /home/administrator/docker-compose/nextcloud &&
docker-compose pull &&
docker-compose up -d
```
Afterwards update the ***nextcloud_version*** variable to the next version and run the server manager.
It is only possible to update from one to the next major version at a time
You can check the status of the update by typing in:
```bash
docker logs nextcloud_application_1
```
If nextcloud stays in the maintenance mode after the update try the following:
```bash
docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ maintenance:mode --on
docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ upgrade
docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ maintenance:mode --off
```
If the update process fails execute
```bash
docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ maintenance:repair
```
and disable the mal functioning apps.
### recover latest backup
```bash
cd /home/administrator/docker-compose/nextcloud &&
docker-compose down &&
cd /usr/local/bin/docker-volume-backup &&
bash ./docker-volume-recover.sh "nextcloud_data" "$(sha256sum /etc/machine-id | head -c 64)" &&
bash ./docker-volume-recover.sh "nextcloud_database" "$(sha256sum /etc/machine-id | head -c 64)"
```
### database debuging
```bash
docker exec -it nextcloud_database_1 mysql -u nextcloud -p
```
### occ
To use occ run:
```bash
docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ
```
### app relevant tables
- oc_appconfig
- oc_migrations
### initialize duplicates
```bash
sudo docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ duplicates:find-all --output
```
### unlock files
```bash
docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ maintenance:mode --on
docker exec -it nextcloud_database_1 mysql -u nextcloud -pPASSWORD1234132 -D nextcloud -e "delete from oc_file_locks where 1"
docker exec -it -u www-data nextcloud_application_1 /var/www/html/occ maintenance:mode --off
```
## architecture
### Maria DB
Until NC24 MariaDB version has to be used.
## performance
### 504 Gateway Timeout
```bash
docker logs nextcloud_web_1 --tail 1000 | grep 504
```
#### See
- https://support.f5.com/csp/article/K48373902
- https://github.com/nextcloud/server/issues/25436
- https://help.nextcloud.com/t/update-to-next-cloud-21-0-2-has-get-an-error/117028/23?page=2
- https://serverfault.com/questions/178671/nginx-php-fpm-504-gateway-time-out-error-with-almost-zero-load-on-a-test-se
- https://help.nextcloud.com/t/solved-manual-lemp-install-php-fpm-timing-out/39070
## further information
- https://github.com/nextcloud/docker/blob/master/.examples/docker-compose/with-nginx-proxy/mariadb/fpm/docker-compose.yml
- https://goneuland.de/nextcloud-upgrade-auf-neue-versionen-mittels-docker/
- https://help.nextcloud.com/t/cant-start-nextcloud-because-the-version-of-the-data-is-higher-than-the-docker-image-version-and-downgrading-is-not-supported/109438
- https://github.com/nextcloud/docker/issues/1302
- https://help.nextcloud.com/t/update-to-22-failed-with-database-error-updated/120682
- https://help.nextcloud.com/t/nc-update-to-21-0-0-beta1-exception-database-error/101124/4
- https://wolfgang.gassler.org/reset-password-mariadb-mysql-docker/
- https://unix.stackexchange.com/questions/478855/ansible-docker-container-and-depends-on
- https://github.com/gdiepen/docker-convenience-scripts