From 465a49f14bcf3d00c3877ddfb048a8fc5eeea1e6 Mon Sep 17 00:00:00 2001 From: LinuxServer-CI Date: Tue, 12 Feb 2019 09:39:55 -0500 Subject: [PATCH] Bot Updating Templated Files --- images/docker-nextcloud.md | 177 ++++++++++++++++++++++++------------- 1 file changed, 116 insertions(+), 61 deletions(-) diff --git a/images/docker-nextcloud.md b/images/docker-nextcloud.md index a7d7c40a8..499eaeedf 100755 --- a/images/docker-nextcloud.md +++ b/images/docker-nextcloud.md @@ -1,98 +1,153 @@ -[linuxserverurl]: https://linuxserver.io -[forumurl]: https://forum.linuxserver.io -[ircurl]: https://www.linuxserver.io/irc/ -[podcasturl]: https://www.linuxserver.io/podcast/ -[appurl]: https://nextcloud.com/ -[hub]: https://hub.docker.com/r/linuxserver/nextcloud/ +# [linuxserver/nextcloud](https://github.com/linuxserver/docker-nextcloud) -[![linuxserver.io](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png)][linuxserverurl] +[![](https://img.shields.io/discord/354974912613449730.svg?logo=discord&label=LSIO%20Discord&style=flat-square)](https://discord.gg/YWrKVTn) +[![](https://images.microbadger.com/badges/version/linuxserver/nextcloud.svg)](https://microbadger.com/images/linuxserver/nextcloud "Get your own version badge on microbadger.com") +[![](https://images.microbadger.com/badges/image/linuxserver/nextcloud.svg)](https://microbadger.com/images/linuxserver/nextcloud "Get your own version badge on microbadger.com") +![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/nextcloud.svg) +![Docker Stars](https://img.shields.io/docker/stars/linuxserver/nextcloud.svg) +[![Build Status](https://ci.linuxserver.io/buildStatus/icon?job=Docker-Pipeline-Builders/docker-nextcloud/master)](https://ci.linuxserver.io/job/Docker-Pipeline-Builders/job/docker-nextcloud/job/master/) +[![](https://lsio-ci.ams3.digitaloceanspaces.com/linuxserver/nextcloud/latest/badge.svg)](https://lsio-ci.ams3.digitaloceanspaces.com/linuxserver/nextcloud/latest/index.html) -The [LinuxServer.io][linuxserverurl] team brings you another container release featuring easy user mapping and community support. Find us for support at: -* [forum.linuxserver.io][forumurl] -* [IRC][ircurl] on freenode at `#linuxserver.io` -* [Podcast][podcasturl] covers everything to do with getting the most from your Linux Server plus a focus on all things Docker and containerisation! - -# linuxserver/nextcloud -[![](https://images.microbadger.com/badges/version/linuxserver/nextcloud.svg)](https://microbadger.com/images/linuxserver/nextcloud "Get your own version badge on microbadger.com")[![](https://images.microbadger.com/badges/image/linuxserver/nextcloud.svg)](https://microbadger.com/images/linuxserver/nextcloud "Get your own image badge on microbadger.com")[![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/nextcloud.svg)][hub][![Docker Stars](https://img.shields.io/docker/stars/linuxserver/nextcloud.svg)][hub][![Build Status](https://ci.linuxserver.io/buildStatus/icon?job=Docker-Builders/x86-64/x86-64-nextcloud)](https://ci.linuxserver.io/job/Docker-Builders/job/x86-64/job/x86-64-nextcloud/) - -[Nextcloud][appurl] gives you access to all your files wherever you are. +[Nextcloud](https://nextcloud.com/) gives you access to all your files wherever you are. Where are your photos and documents? With Nextcloud you pick a server of your choice, at home, in a data center or at a provider. And that is where your files will be. Nextcloud runs on that server, protecting your data and giving you access from your desktop or mobile devices. Through Nextcloud you also access, sync and share your existing data on that FTP drive at the office, a Dropbox or a NAS you have at home. -[![nextcloud](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/nextcloud-icon.png)][appurl] + +## Supported Architectures + +Our images support multiple architectures such as `x86-64`, `arm64` and `armhf`. We utilise the docker manifest for multi-platform awareness. More information is available from docker [here](https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list). + +Simply pulling `linuxserver/nextcloud` should retrieve the correct image for your arch, but you can also pull specific arch images via tags. + +The architectures supported by this image are: + +| Architecture | Tag | +| :----: | --- | +| x86-64 | amd64-latest | +| arm64 | arm64v8-latest | +| armhf | arm32v6-latest | + ## Usage +Here are some example snippets to help you get started creating a container from this image. + +### docker + ``` docker create \ - --name nextcloud \ - -p 443:443 \ - -e PUID= -e PGID= \ - -v :/config \ - -v :/data \ - linuxserver/nextcloud + --name=nextcloud \ + -e PUID=1001 \ + -e PGID=1001 \ + -e TZ=Europe/London \ + -p 443:443 \ + -v :/config \ + -v :/data \ + --restart unless-stopped \ + linuxserver/nextcloud +``` + + +### docker-compose + +Compatible with docker-compose v2 schemas. + +```yaml +--- +version: "2" +services: + nextcloud: + image: linuxserver/nextcloud + container_name: nextcloud + environment: + - PUID=1001 + - PGID=1001 + - TZ=Europe/London + volumes: + - :/config + - :/data + ports: + - 443:443 + mem_limit: 4096m + restart: unless-stopped ``` ## Parameters -`The parameters are split into two halves, separated by a colon, the left hand side representing the host and the right the container side. -For example with a port -p external:internal - what this shows is the port mapping from internal to external of the container. -So -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 -http://192.168.x.x:8080 would show you what's running INSIDE the container on port 80.` +Docker images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `:` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container. + +### Ports (`-p`) + +| Parameter | Function | +| :----: | --- | +| `443` | WebUI | -* `-p 443` - the port nextcloud web interface -* `-v /config` - nextcloud configs -* `-v /data` - your personal data -* `-e PGID` for for GroupID - see below for explanation -* `-e PUID` for for UserID - see below for explanation +### Environment Variables (`-e`) -It is based on Alpine Linux with s6 overlay, for shell access whilst the container is running do `docker exec -it nextcloud /bin/bash` +| Env | Function | +| :----: | --- | +| `PUID=1001` | for UserID - see below for explanation | +| `PGID=1001` | for GroupID - see below for explanation | +| `TZ=Europe/London` | Specify a timezone to use EG Europe/London. | -### User / Group Identifiers +### Volume Mappings (`-v`) -Sometimes when using data volumes (`-v` flags) permissions issues can arise between the host OS and the container. We avoid this issue by allowing you to specify the user `PUID` and group `PGID`. Ensure the data volume directory on the host is owned by the same user you specify and it will "just work" TM. +| Volume | Function | +| :----: | --- | +| `/config` | Nextcloud configs. | +| `/data` | Your personal data. | -In this instance `PUID=1001` and `PGID=1001`. To find yours use `id user` as below: + + +## User / Group Identifiers + +When using volumes (`-v` flags), permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`. + +Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic. + +In this instance `PUID=1001` and `PGID=1001`, to find yours use `id user` as below: ``` - $ id + $ id username uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup) ``` -## Setting up the application +## Application Setup + Access the webui at `:443`, for more information check out [Nextcloud][appurl]. Please note you will need a MySQL/MariaDB or other backend database to set this up. Also please look [here](https://docs.nextcloud.com/server/11/admin_manual/installation/system_requirements.html#database-requirements-for-mysql-mariadb) for how to configure your database with regard to binlog format and installation. If updating to nextcloud 12 you will need to comment out line `add_header X-Frame-Options "SAMEORIGIN";` in the file /config/nginx/site-confs/default -## Info -* Monitor the logs of the container in realtime `docker logs -f nextcloud`. -* container version number +## Support Info -`docker inspect -f '{{ index .Config.Labels "build_version" }}' nextcloud` - -* image version number - -`docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/nextcloud` +* Shell access whilst the container is running: + * `docker exec -it nextcloud /bin/bash` +* To monitor the logs of the container in realtime: + * `docker logs -f nextcloud` +* Container version number + * `docker inspect -f '{{ index .Config.Labels "build_version" }}' nextcloud` +* Image version number + * `docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/nextcloud` ## Versions -+ **28.01.19:** Add pipeline logic and multi arch. -+ **25.01.19:** Add php7-phar for occ upgrades. -+ **05.09.18:** Rebase to alpine 3.8. -+ **11.06.18:** Use latest rather than specific version for initial install. -+ **26.04.18:** Bump default install to 13.0.1. -+ **06.02.18:** Bump default install to 13.0.0. -+ **26.01.18:** Rebase to alpine 3.7, bump default install to 12.0.5. -+ **12.12.17:** Bump default install to 12.0.4, fix continuation lines. -+ **15.10.17:** Sed php.ini for opcache requirements in newer nextcloud versions. -+ **20.09.17:** Bump default install to 12.0.3. -+ **19.08.17:** Bump default install to 12.0.2. -+ **25.05.17:** Rebase to alpine 3.6. -+ **22.05.17:** Update to nextcloud 12.0, adding required dependecies and note about commenting out SAMEORIGIN; line. -+ **03.05.17:** Use community repo of memcached. -+ **07.03.17:** Release into main repository and upgrade to php7 and Alpine 3.5. +* **28.01.19:** - Add pipeline logic and multi arch. +* **25.01.19:** - Add php7-phar for occ upgrades. +* **05.09.18:** - Rebase to alpine 3.8. +* **11.06.18:** - Use latest rather than specific version for initial install. +* **26.04.18:** - Bump default install to 13.0.1. +* **06.02.18:** - Bump default install to 13.0.0. +* **26.01.18:** - Rebase to alpine 3.7, bump default install to 12.0.5. +* **12.12.17:** - Bump default install to 12.0.4, fix continuation lines. +* **15.10.17:** - Sed php.ini for opcache requirements in newer nextcloud versions. +* **20.09.17:** - Bump default install to 12.0.3. +* **19.08.17:** - Bump default install to 12.0.2. +* **25.05.17:** - Rebase to alpine 3.6. +* **22.05.17:** - Update to nextcloud 12.0, adding required dependecies and note about commenting out SAMEORIGIN; line. +* **03.05.17:** - Use community repo of memcache. +* **07.03.17:** - Release into main repository and upgrade to php7 and Alpine 3.5.