264 lines
11 KiB
Markdown
Raw Normal View History

2016-06-16 12:54:04 +02:00
## wonderfall/nextcloud
2016-09-23 19:42:04 +02:00
[![](https://images.microbadger.com/badges/version/wonderfall/nextcloud.svg)](http://microbadger.com/images/wonderfall/nextcloud "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/wonderfall/nextcloud.svg)](http://microbadger.com/images/wonderfall/nextcloud "Get your own image badge on microbadger.com")
2016-08-21 15:52:20 +02:00
2016-09-28 21:24:25 +02:00
![](https://s32.postimg.org/69nev7aol/Nextcloud_logo.png)
2016-10-12 10:39:15 +02:00
### Features
2016-10-17 12:41:47 +02:00
- Based on Alpine Linux Edge.
2016-09-23 19:42:04 +02:00
- Bundled with nginx and PHP 7.
2016-10-12 10:23:28 +02:00
- Automatic installation using environment variables.
2016-09-23 19:42:04 +02:00
- Package integrity and authenticity checked during building process.
- Data and apps persistence.
2016-10-17 12:41:47 +02:00
- OPCache (opcocde), APCu (local), Redis (file locking) installed and configured.
2016-09-23 19:42:04 +02:00
- system cron task running.
2016-07-30 19:26:07 +02:00
- MySQL, PostgreSQL (server not built-in) and sqlite3 support.
- Redis, FTP, SMB, LDAP support.
2016-09-23 19:42:04 +02:00
- GNU Libiconv for php iconv extension (avoiding errors with some apps).
2016-09-23 19:44:42 +02:00
- No root processes. Never.
2016-09-23 19:42:04 +02:00
- Environment variables provided (see below).
2016-06-16 12:54:04 +02:00
2016-10-14 12:41:10 +02:00
### Notes
2016-10-15 20:06:15 +02:00
- [It has been reported](https://github.com/Wonderfall/dockerfiles/issues/37) that this image might not work well with old versions of aufs. Please update aufs to 4.x or later, or use overlay/btrfs as a replacement.
2016-10-14 12:41:10 +02:00
- HTTP port has recently changed, it's now **8888**. You will have to modify your reverse proxy settings.
2016-10-17 12:41:47 +02:00
- A Redis sever is now running, so you may want to configure it for file locking cache if your config.php was not generated recently. [For best performance it is recommended by Nextcloud documentation](https://docs.nextcloud.com/server/10/admin_manual/configuration_server/caching_configuration.html#additional-notes-for-redis-vs-apcu-on-memory-caching). Add the following lines to your `config.php` :
```
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => array(
'host' => '/tmp/redis.sock',
'port' => 0,
'timeout' => 0.0,
),
```
2016-10-14 12:41:10 +02:00
2016-10-12 10:39:15 +02:00
### Tags
2016-07-01 12:11:22 +02:00
- **latest** : latest stable version.
2016-11-25 18:19:08 +00:00
- **11.0** : latest 11.0.x version (**still in beta**)
2016-08-25 14:58:15 +02:00
- **10.0** : latest 10.0.x version (stable)
- **9.0** : latest 9.0.x version. (old stable) (unmaintained by this project)
2016-07-02 19:01:33 +02:00
- **daily** : latest code (daily build).
2016-07-01 12:11:22 +02:00
2016-09-23 19:42:04 +02:00
Other tags than `daily` are built weekly. For security reasons, you should occasionally update the container, even if you have the latest version of Nextcloud.
2016-10-12 10:39:15 +02:00
### Build-time variables
2016-06-16 12:54:04 +02:00
- **NEXTCLOUD_VERSION** : version of nextcloud
2016-09-23 19:42:04 +02:00
- **GNU_LIBICONV_VERSION** : version of GNU Libiconv
- **GPG_nextcloud** : signing key fingerprint
2016-06-16 12:54:04 +02:00
2016-10-12 10:39:15 +02:00
### Environment variables
2016-06-16 12:54:04 +02:00
- **UID** : nextcloud user id *(default : 991)*
- **GID** : nextcloud group id *(default : 991)*
- **UPLOAD_MAX_SIZE** : maximum upload size *(default : 10G)*
- **APC_SHM_SIZE** : apc memory size *(default : 128M)*
2016-09-19 13:20:26 +02:00
- **OPCACHE_MEM_SIZE** : opcache memory size in megabytes *(default : 128)*
2016-10-17 12:41:47 +02:00
- **REDIS_MAX_MEMORY** : memory limit for Redis *(default : 64mb)*
2016-09-23 19:42:04 +02:00
- **CRON_PERIOD** : time interval between two cron tasks *(default : 15m)*
2016-10-13 14:02:03 +02:00
- **TZ** : the system/log timezone *(default : Etc/UTC)*
- **ADMIN_USER** : username of the admin account *(default : admin)*
- **ADMIN_PASSWORD** : password of the admin account *(default : admin)*
- **DB_TYPE** : database type (sqlite3, mysql or pgsql) *(default : sqlite3)*
- **DB_NAME** : name of database *(default : none)*
- **DB_USER** : username for database *(default : none)*
- **DB_PASSWORD** : password for database user *(default : none)*
- **DB_HOST** : database host *(default : none)*
Don't forget to use a **strong password** for the admin account!
2016-06-16 12:54:04 +02:00
2016-10-12 10:39:15 +02:00
### Port
- **8888** : HTTP Nextcloud port.
2016-07-02 19:01:33 +02:00
2016-10-12 10:39:15 +02:00
### Volumes
2016-07-02 19:01:33 +02:00
- **/data** : Nextcloud data.
- **/config** : config.php location.
- **/apps2** : Nextcloud downloaded apps.
- **/var/lib/redis** : Redis dumpfile location.
2016-07-02 19:01:33 +02:00
2016-10-12 10:39:15 +02:00
### Database
2016-09-23 19:42:04 +02:00
Basically, you can use a database instance running on the host or any other machine. An easier solution is to use an external database container. I suggest you to use MariaDB, which is a reliable database server. You can use the official `mariadb` image available on Docker Hub to create a database container, which must be linked to the Nextcloud container. PostgreSQL can also be used as well.
2016-07-02 19:01:33 +02:00
2016-10-12 10:39:15 +02:00
### Setup
2016-10-13 14:11:19 +02:00
Pull the image and create a container. `/mnt` can be anywhere on your host, this is just an example. Change `MYSQL_ROOT_PASSWORD` and `MYSQL_PASSWORD` values (mariadb). You may also want to change UID and GID for Nextcloud, as well as other variables (see *Environment Variables*).
2016-07-02 19:01:33 +02:00
````
2016-10-13 14:02:03 +02:00
docker pull wonderfall/nextcloud:10.0 && docker pull mariadb:10
docker run -d --name db_nextcloud \
-v /mnt/nextcloud/db:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=supersecretpassword \
-e MYSQL_DATABASE=nextcloud -e MYSQL_USER=nextcloud \
-e MYSQL_PASSWORD=supersecretpassword \
mariadb:10
docker run -d --name nextcloud \
--link db_nextcloud:db_nextcloud \
2016-10-13 14:11:19 +02:00
-v /mnt/nextcloud/data:/data \
-v /mnt/nextcloud/config:/config \
-v /mnt/nextcloud/apps:/apps2 \
2016-10-13 14:02:03 +02:00
-e UID=1000 -e GID=1000 \
2016-10-13 14:11:19 +02:00
-e UPLOAD_MAX_SIZE=10G \
-e APC_SHM_SIZE=128M \
-e OPCACHE_MEM_SIZE=128 \
2016-10-17 12:41:47 +02:00
-e REDIS_MAX_MEMORY=64mb \
2016-10-13 14:11:19 +02:00
-e CRON_PERIOD=15m \
-e TZ=Etc/UTC \
-e ADMIN_USER=mrrobot \
-e ADMIN_PASSWORD=supercomplicatedpassword \
2016-10-13 14:02:03 +02:00
-e DB_TYPE=mysql \
-e DB_NAME=nextcloud \
-e DB_USER=nextcloud \
-e DB_PASSWORD=supersecretpassword \
-e DB_HOST=db_nextcloud \
wonderfall/nextcloud:10.0
2016-07-02 19:01:33 +02:00
```
2016-06-16 12:54:04 +02:00
2016-09-23 19:42:04 +02:00
**Below you can find a docker-compose file, which is very useful!**
2016-07-02 19:01:33 +02:00
2016-10-13 14:11:19 +02:00
Now you have to use a **reverse proxy** in order to access to your container through Internet, steps and details are available at the end of the README.md. And that's it! Since you already configured Nextcloud through setting environment variables, there's no setup page.
2016-07-02 19:01:33 +02:00
2016-10-15 20:06:15 +02:00
### ARM-based devices
This image is available for `armhf` (Raspberry Pi 1 & 2, Scaleway C1, ...). Although Docker does support ARM-based devices, Docker Hub only builds for x86_64. That's why you will have to build this image yourself! Don't panic, this is easy.
```
git clone https://github.com/Wonderfall/dockerfiles.git
cd dockerfiles/nextcloud/10.0-armhf
2016-10-15 20:07:24 +02:00
docker build -t wonderfall/nextcloud .
2016-10-15 20:06:15 +02:00
```
The building process can take some time.
2016-10-12 10:39:15 +02:00
### Configure
2016-07-02 19:01:33 +02:00
In the admin panel, you should switch from `AJAX cron` to `cron` (system cron).
2016-06-16 12:54:04 +02:00
2016-10-12 10:39:15 +02:00
### Update
2016-10-13 14:11:19 +02:00
Pull a newer image, then recreate the container as you did before (*Setup* step). None of your data will be lost since you're using external volumes. If Nextcloud performed a full upgrade, your apps could be disabled, enable them again.
2016-07-02 19:01:33 +02:00
2016-10-12 10:39:15 +02:00
### Docker-compose
I advise you to use [docker-compose](https://docs.docker.com/compose/), which is a great tool for managing containers. You can create a `docker-compose.yml` with the following content (which must be adapted to your needs) and then run `docker-compose up -d nextcloud-db`, wait some 15 seconds for the database to come up, then run everything with `docker-compose up -d`, that's it! On subsequent runs, a single `docker-compose up -d` is sufficient!
2016-06-16 17:03:55 +02:00
2016-10-12 10:39:15 +02:00
#### Docker-compose file V2
2016-06-16 12:54:04 +02:00
```
version: '2'
volumes:
nextcloud-db-data:
nextcloud-data:
nextcloud-config:
nextcloud-apps:
services:
nextcloud-db:
image: mariadb
volumes:
- nextcloud-db-data:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=1234
- MYSQL_DATABASE=nextcloud
- MYSQL_USER=nextcloud
- MYSQL_PASSWORD=foo5678
nextcloud:
image: wonderfall/nextcloud
environment:
- UID=1000
- GID=1000
- UPLOAD_MAX_SIZE=10G
- APC_SHM_SIZE=128M
- OPCACHE_MEM_SIZE=128
2016-10-17 12:41:47 +02:00
- REDIS_MAX_MEMORY=64mb
- CRON_PERIOD=15m
- TZ=Europe/Berlin
- ADMIN_USER=admin
- ADMIN_PASSWORD=admin
- DB_TYPE=mysql
- DB_NAME=nextcloud
- DB_USER=nextcloud
- DB_PASSWORD=foo5678
- DB_HOST=nextcloud-db
depends_on:
- nextcloud-db
volumes:
- nextcloud-data:/data
- nextcloud-config:/config
- nextcloud-apps:/apps2
2016-10-13 14:02:03 +02:00
# ports:
# - 8888:8888
2016-06-16 12:54:04 +02:00
```
2016-10-12 10:39:15 +02:00
#### Docker-compose file V1
```
nextcloud:
image: wonderfall/nextcloud
links:
2016-10-13 14:11:19 +02:00
- nextcloud-db:nextcloud-db
environment:
- UID=1000
- GID=1000
- UPLOAD_MAX_SIZE=10G
- APC_SHM_SIZE=128M
- OPCACHE_MEM_SIZE=128
2016-10-17 12:41:47 +02:00
- REDIS_MAX_MEMORY=64mb
- CRON_PERIOD=15m
- TZ=Europe/Berlin
- ADMIN_USER=admin
- ADMIN_PASSWORD=admin
- DB_TYPE=mysql
- DB_NAME=nextcloud
- DB_USER=nextcloud
- DB_PASSWORD=supersecretpassword
- DB_HOST=nextcloud-db
volumes:
- /mnt/nextcloud/data:/data
- /mnt/nextcloud/config:/config
- /mnt/nextcloud/apps:/apps2
nextcloud-db:
image: mariadb:10
volumes:
- /mnt/nextcloud/db:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=supersecretpassword
- MYSQL_DATABASE=nextcloud
- MYSQL_USER=nextcloud
- MYSQL_PASSWORD=supersecretpassword
```
2016-07-02 19:01:33 +02:00
You can update everything with `docker-compose pull` followed by `docker-compose up -d`.
2016-06-16 12:54:04 +02:00
2016-10-12 10:39:15 +02:00
### Reverse proxy
2016-10-13 14:11:19 +02:00
Of course you can use your own solution to do so! nginx, Haproxy, Caddy, h2o, there's plenty of choices and documentation about it on the Web.
2016-10-13 14:02:03 +02:00
Personally I'm using nginx, so if you're using nginx, there are two possibilites :
- nginx is on the host : get the Nextcloud container IP address with `docker inspect nextcloud | grep IPAddress\" | head -n1 | grep -Eo "[0-9.]+" `. But whenever the container is restarted or recreated, its IP address can change. Or you can bind Nextcloud HTTP port (8888) to the host (so the reverse proxy can access with `http://localhost:8888` or whatever port you set), but in this case you should consider using a firewall since it's also listening to `http://0.0.0.0:8888`.
2016-10-15 20:06:15 +02:00
- nginx is in a container, things are easier : you can link nextcloud container to an nginx container so you can use `proxy_pass http://nextcloud:8888`. If you're interested, I provide a nginx image available on Docker Hub : `wonderfall/boring-nginx`, and it comes with a script called `ngxproxy`, which does all the magic after asking you a few questions. Otherwise, an example of configuration would be :
2016-09-23 19:42:04 +02:00
2016-10-13 14:02:03 +02:00
```
server {
listen 8000;
server_name example.com;
return 301 https://$host$request_uri;
}
server {
listen 4430 ssl http2;
server_name example.com;
ssl_certificate /certs/example.com.crt;
ssl_certificate_key /certs/example.com.key;
include /etc/nginx/conf/ssl_params.conf;
client_max_body_size 10G; # change this value it according to $UPLOAD_MAX_SIZE
location / {
proxy_pass http://nextcloud:8888;
include /etc/nginx/conf/proxy_params;
}
}
```
2016-07-02 19:01:33 +02:00
2016-06-16 12:54:04 +02:00
2016-09-23 19:42:04 +02:00
Headers are already sent by the container, including HSTS, so there's no need to add them again. **It is strongly recommended to use Nextcloud through an encrypted connection (HTTPS).** [Let's Encrypt](https://letsencrypt.org/) provides free SSL/TLS certificates (trustworthy!).