wiki/wiki/owncloud.md

# Owncloud

## Setup Server

### Docker

The official container and documentation was made by [owncloud](https://hub.docker.com/_/owncloud).
This docker-rebuild is made up by a `docker-compose.yml` file.
The services in this files are explained seperately.

#### Owncloud

##### Volumes

Set the following volumes in the `volumes:` section of the docker-compose file.

| Volume-Name | Container mount      | Description                  |
| ----------- | -------------------- | ---------------------------- |
| owncloud    | /var/www/html        | storage for owncloud plugins |
| config      | /var/www/html/config | storage for owncloud config  |

##### Ports

Set the following ports in the `ports:` section.

| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 80             | 80                       | TCP      | WebUI       |

#### Maria DB

##### Environment-variables

Set the following environment-variables in the `environment:` section of the docker-compose file.

| Name                | Usage                        | Default |
| ------------------- | ---------------------------- | ------- |
| MYSQL\_ROOT\_PASSWORD | set the mysql admin password |         |

##### Volumes

Set the following volumes in the `volumes:` section of the docker-compose file.

| Volume-Name | Container mount | Description               |
| ----------- | --------------- | ------------------------- |
| mariadb     | /var/lib/mysql  | storage for owncloud data |

#### Rebuild

```
#!/bin/sh
docker-compose down
docker pull owncloud
docker pull mariadb
docker-compose up -d
```

#### Docker-Compose.yml

```
version: '3.1'

services:

  owncloud:
    image: owncloud
    restart: unless-stopped
    ports:
      - 80:80
    volumes:
      - owncloud:/var/www/html
      - config:/var/www/html/config

  mariadb:
    image: mariadb
    restart: unless-stopped
    environment:
        MYSQL_ROOT_PASSWORD: pass
    volumes:
      - mariadb:/var/lib/mysql

volumes:
  owncloud:
    driver: local
  mariadb:
    driver: local
  config:
    driver: local
```

## Setup Client

### Docker

The original container and documentation are made by [tiynger](https://hub.docker.com/r/tiynger/owncloudclient)

#### Environment-variables

Set the following variables with the -e tag.

| Name     | Usage                                               | Default   |
| -------- | --------------------------------------------------- | --------- |
| USER     | username of OwnCloud server                         | admin     |
| PASSWORD | password of OwnCloud server                         | admin     |
| URL      | url of OwnCloud server (dont forget the http(s)://) | localhost |

#### Additional

There are some special variables to set.

| Flag               | Usage                                                      |
| ------------------ | ---------------------------------------------------------- |
| --opt-log max-size | prevent log file from growing to large (`50m` recommended) |

#### Volumes

Set the following volumes with the -v tag.

| Volume-Name | Container mount | Description                         |
| ----------- | --------------- | ----------------------------------- |
| data        | /data           | directory for the owncloud contents |

#### Rebuild

```
#!/bin/sh
docker stop owncloudcli
docker rm owncloudcli
docker pull tiynger/owncloudclient
docker run --name owncloudcli \
	--restart unless-stopped \
	-v owncloudcli:/data \
	-e USER='user' \
	-e PASSWORD='password' \
	-e URL='https://subdomain.domain.tld' \
        --log-opt max-size=50m \
	-d tiynger/owncloudclient
```

## Error handling

### Problems with a locked file

It is possible that you can't remove or move a locked file.
If this problem doesn't resolve after a restart you can try to disable locking in the owncloud config.
This is done by adding the line `'filelocking.enabled' => false,` into the file `config/config.php`.
Then try to resolve the error.
Afterwards enable locking again by removing the added line.

The reason I choose this process over editing the database file, is ease of use.
The editing of the database is much more time consuming especially if run with docker.