Skip to content
This repository has been archived by the owner on Oct 24, 2024. It is now read-only.

Commit

Permalink
chore: Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@chrootlogin
chrootlogin authored Oct 24, 2024
1 parent 379ffd7 commit 5e13be7
Showing 1 changed file with 2 additions and 218 deletions.
220 changes: 2 additions & 218 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,222 +2,6 @@

![](https://s32.postimg.org/69nev7aol/Nextcloud_logo.png)

[![Docker Repository on Quay](https://quay.io/repository/rootlogin/nextcloud/status "Docker Repository on Quay")](https://quay.io/repository/rootlogin/nextcloud) [![](https://images.microbadger.com/badges/version/rootlogin/nextcloud.svg)](http://microbadger.com/images/rootlogin/nextcloud "Get your own version badge on microbadger.com") [![](https://images.microbadger.com/badges/image/rootlogin/nextcloud.svg)](http://microbadger.com/images/rootlogin/nextcloud "Get your own image badge on microbadger.com") [![](https://images.microbadger.com/badges/commit/rootlogin/nextcloud.svg)](https://microbadger.com/images/rootlogin/nextcloud "Get your own commit badge on microbadger.com")
This image has been moved to [erhardtconsulting/images](https://github.com/erhardtconsulting/images/tree/main/nextcloud).

Easy usable docker image for [Nextcloud](http://nextcloud.com), the community fork of OwnCloud.

## Features

* Uses latest stable version of **Alpine Linux**, bundled with **PHP 7** and **NGinx**.
* GPG check during building process.
* APCu already configured.
* LDAP support.
* Cron runs all 15 mins (No need for web or AJAX cron).
* Persistence for data, configuration and apps.
* Nextcloud included apps that are persistent will be automatically updated during start.
* Works with MySQL/MariaDB and PostgreSQL (server not included).
* Supports uploads up to 10GB.
* This image is also available via [Quay.io](http://quay.io/rootlogin/nextcloud).
* **NEW!** Multi architecture support (x86,amd64,armv6,armv7,arm64,ppc64le,s390x)!

## Container environment

### Included software

* Alpine Linux
* PHP 7
* APCu
* NGinx
* cron
* SupervisorD

Everything is bundled in the newest stable version.

### Tags

* **latest**: Latest stable Nextcloud version (PHP 7)
* **X.X.X**: Stable version tags of Nextcloud (e.g. v9.0.52) (Version >= 12.0.0 use PHP 7)
* **develop**: Latest development branch (may unstable)
* **TAG-ARCHITECTURE** (Example: develop-arm64): Tag with fixed processor architecture

### Build-time arguments
* **NEXTCLOUD_GPG**: Fingerprint of Nextcloud signing key
* **NEXTCLOUD_VERSION**: Nextcloud version to install
* **UID**: User ID of the nextcloud user (default 1501)
* **GID**: Group ID of the nextcloud user (default 1501)

### Exposed ports
- **80**: NGinx webserver running Nextcloud.

### Volumes
- **/data** : All data, including config and user downloaded apps (in subfolders).

## Usage

### Standalone

You can run Nextcloud without a separate database, but I don't recommend it for production setups as it uses SQLite. Another solution is to use an external database provided elsewhere, you can enter the credentials in the installer.

1. Pull the image: `docker pull rootlogin/nextcloud`
2. Run it: `docker run -d --name nextcloud -p 80:80 -v my_local_data_folder:/data rootlogin/nextcloud` (Replace *my_local_data_folder* with the path where do you want to store the persistent data)
3. Open [localhost](http://localhost) and profit!

The first time you run the application, you can use the Nextcloud setup wizard to install everything. Afterwards it will run directly.

### With a database container

For standard setups I recommend the use of MariaDB, because it is more reliable than SQLite. For example, you can use the offical docker image of MariaDB. For more information refer to the according docker image.

```
# docker pull rootlogin/nextcloud && docker pull mariadb:10
# docker run -d --name nextcloud_db -v my_db_persistence_folder:/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 nextcloud_db:nextcloud_db -p 80:80 -v my_local_data_folder:/data rootlogin/nextcloud
```

*The auto-connection of the database to nextcloud is not implemented yet. This is why you need to do that manually.*

## Configuration

You can configure Nextcloud via the occ command:

```
# docker exec -ti nextcloud occ [...YOUR COMMANDS...]
```

The command uses the same user as the webserver.

## Other

### Migrate from OwnCloud

You can easily migrate an existing OwnCloud to this Nextcloud docker image.

**Before starting, always make a backup of your old OwnCloud instance. I told you so!**

1. Enable the maintenance mode on your old OwnCloud instance, e.g. `sudo -u www-data ./occ maintenance:mode --on`
2. Create a new folder e.g. /var/my_nextcloud_data
3. Create a new subfolder called "config" and copy the config.php from your existing instance in there.
4. Copy your existing "data" folder to */var/my_nextcloud_data*/data
5. Start the docker container: `docker run -d --name nextcloud -p 80:80 -v /var/my_nextcloud_data:/data rootlogin/nextcloud`
6. Wait until everything is running.
7. Start the Nextcloud migration command: `docker exec nextcloud occ upgrade`
8. Disable the maintenance mode of Nextcloud: `docker exec nextcloud occ maintenance:mode --off`
9. **Profit!**

### Run container with systemd

I usually run my containers on behalf of systemd, with the following config:

```
[Unit]
Description=Docker - Nextcloud container
Requires=docker.service
After=docker.service
[Service]
Restart=always
ExecStart=/usr/bin/docker run -p 127.0.0.1:8000:80 -v /data/nextcloud:/data --name nextcloud rootlogin/nextcloud
ExecStop=/usr/bin/docker stop -t 2 nextcloud ; /usr/bin/docker rm -f nextcloud
[Install]
WantedBy=default.target
```

### NGinx frontend proxy

This container does not support SSL or similar and is therefore not made for running directly in the world wide web. You better use a frontend proxy like another NGinx.

Here are some sample configs (The config need to be adapted):

```
server {
listen 80;
server_name cloud.example.net;
# ACME handling for Letsencrypt
location /.well-known/acme-challenge {
alias /var/www/letsencrypt/;
default_type "text/plain";
try_files $uri =404;
}
location / {
return 301 https://$host$request_uri;
}
}
server {
listen 443 ssl spdy;
server_name cloud.example.net;
ssl_certificate /etc/letsencrypt.sh/certs/cloud.example.net/fullchain.pem;
ssl_certificate_key /etc/letsencrypt.sh/certs/cloud.example.net/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt.sh/certs/cloud.example.net/chain.pem;
ssl_dhparam /etc/nginx/dhparam.pem;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 30m;
ssl_prefer_server_ciphers on;
ssl_ciphers "ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA:DES-CBC3-SHA:HIGH:!aNULL:!eNULL:!EXPORT:!DES:!MD5:!PSK:!RC4";
ssl_stapling on;
ssl_stapling_verify on;
add_header Strict-Transport-Security "max-age=31536000";
access_log /var/log/nginx/docker-nextcloud_access.log;
error_log /var/log/nginx/docker-nextcloud_error.log;
location / {
proxy_buffers 16 4k;
proxy_buffer_size 2k;
proxy_read_timeout 300;
proxy_connect_timeout 300;
proxy_redirect off;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Frame-Options SAMEORIGIN;
client_max_body_size 10G;
proxy_pass http://127.0.0.1:8000;
}
}
```

## Frequently Asked Questions

**Why does the start take so long?**

When you run the container it will reset the permissions on the /data folder. This means if you have much data, it takes some time. This helps to avoid permission issues.

## Overwritten config

Some parameters in the Nextcloud configuration will be overwritten by the file in `root/opt/nextcloud/config/docker.config.php`

## Group/User ID

You can change the numerical user id and group id via build arguments.

```
$ git clone https://github.com/chrootLogin/docker-nextcloud.git && cd docker-nextcloud
$ docker build -t rootlogin/nextcloud --build-arg UID=1000 --build-arg GID=1000 .
$ docker run -p 80:80 rootlogin/nextcloud
```

## Contribution

This stuff is released under GPL. I'm happy about every pull-request, that makes this tool better.

## Donate

If you want to donate for this project you can do it through [Github Sponsorship](https://github.com/sponsors/chrootlogin/).

Or you can send me some crypto-coins to the following address:

**Bitcoin**: bc1qvemyhud469qe4v6lcsn8sxu5e57m4sw3u2ujff
There you find the new rootless and Kubernetes-compatible all-in-one Docker image.

0 comments on commit 5e13be7

Please sign in to comment.