The official Nextcloud installation method. Provides easy deployment and maintenance with most features included in this one Nextcloud instance.
Find a file
szaimen 566c8b2a5d add notice about reverse proxies
Signed-off-by: szaimen <szaimen@e.mail.de>
2021-12-04 16:45:25 +01:00
app add the app into the container and upgrade to 23 2021-11-30 12:50:08 +01:00
Containers make the datadirectory more robust 2021-12-04 11:01:38 +01:00
php make the datadirectory more robust 2021-12-04 11:01:38 +01:00
.gitignore Initial import 2021-11-30 11:20:42 +01:00
CODEOWNERS Create CODEOWNERS 2021-11-30 11:50:18 +01:00
develop.md Initial import 2021-11-30 11:20:42 +01:00
LICENSE Add license file 2021-12-01 14:30:56 +01:00
readme.md add notice about reverse proxies 2021-12-04 16:45:25 +01:00

Nextcloud All In One Beta

This is beta software and not production ready. But feel free to use it at your own risk! We expect there to be rough edges and potentially serious bugs.

Nextcloud AIO stands for Nextcloud All In One and provides easy deployment and maintenance with most features included in this one Nextcloud instance.

Included are:

  • Nextcloud
  • Nextcloud Office
  • High performance backend for Nextcloud Files
  • High performance backend for Nextcloud Talk
  • Backup solution (based on BorgBackup)

Found a bug? Please file an issue at https://github.com/nextcloud/all-in-one

How to use this?

  1. Install Docker on your Linux installations using:
curl -fsSL get.docker.com | sudo sh
  1. Make sure to pull the latest image:
sudo docker pull nextcloud/all-in-one:latest
  1. Run the following command in order to start the container:
sudo docker run -it \
--name nextcloud-aio-mastercontainer \
--restart always \
-p 80:80 \
-p 8080:8080 \
-p 8443:8443 \
--volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \
--volume /var/run/docker.sock:/var/run/docker.sock:ro \
nextcloud/all-in-one:latest
  1. After the initial startup, you should be able to open the Nextcloud AIO Interface now on port 8080 of this server.
    E.g. https://internal.ip.of.this.server:8080
    If your server has port 80 and 8443 open and you point a domain to your server, you can get a valid certificate automatially by opening the Nextcloud AIO Interface via:
    https://your-domain-that-points-to-this-server.tld:8443

FAQ

Which ports are mandatory to be open?

Only those (if you acces the Mastercontainer Interface internally via port 8080):

  • 443/TCP for the Nextcloud container
  • 3478/TCP and 3478/UPD for the Talk container

Explanation of used ports:

  • 8080/TCP: Mastercontainer Interface with self-signed certificate (works always, also if only access via IP-address is possible, e.g. https://internal.ip.address:8080/)
  • 80/TCP: redirects to Nextcloud (is used for getting the certificate via ACME http-challenge for the Mastercontainer)
  • 8443/TCP: Mastercontainer Interface with valid certificate (only works if port 80 and 8443 are open and you point a domain to your server. It generates a valid certificate then automatically and access via e.g. https://public.domain.com:8443/ is possible.)
  • 443/TCP: will be used by the Nextcloud container later on and needs to be open
  • 3478/TCP and 3478/UPD: will be used by the Turnserver inside the Talk container and needs to be open

Are reverse proxies supported?

Reverse proxies are currently not supported.
You might investigate yourself though how it could made work behind reverse proxies. If you open a PR with that we might consider it then :)

How to resolve Security & setup warnings displays the "missing default phone region" after initial install?

Simply run the following command: sudo docker exec -it nextcloud-aio-nextcloud php occ config:system:set default_phone_region --value="yourvalue". Of course you need to modify yourvalue based on your location. Examples are DE, EN and GB. See this list for more codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements

Backup solution

Nextcloud AIO provides a local backup solution based on BorgBackup. These backups act as a local restore point in case the installation gets corrupted.

It is recommended to create a backup before any container update. By doing this, you will be safe regarding any possible complication during updates because you will be able to restore the whole instance with basically one click.

If you connect an external drive to your host, and choose the backup directory to be on that drive, you are also kind of save against drive failures of the drive where the docker volumes are stored on.

Backups can be created and restored in the AIO interface using the buttons Create Backup and Restore last backup. Additionally, a backup check is provided that checks the integrity of your backups but it shouldn't be needed in most situations.

The backups itself get encrypted with an encryption key that gets shown to you in the AIO interface. Please save that at a safe place as you will not be able to restore from backup without this key.

Note that this implementation does not provide remote backups, for this you can use the backup app.