nextcloud/all-in-one

📦 The official Nextcloud installation method. Provides easy deployment and maintenance with most features included in this one Nextcloud instance.

Nextcloud All-in-One

The official Nextcloud installation method. Nextcloud AIO provides easy deployment and maintenance with most features included in this one Nextcloud instance.

Included are:

• Nextcloud
• High performance backend for Nextcloud Files
• Nextcloud Office (optional)
• High performance backend for Nextcloud Talk and TURN-server (optional)
• Nextcloud Talk Recording-server (optional)
• Backup solution (optional, based on BorgBackup)
• Imaginary (optional, for previews of heic, heif, illustrator, pdf, svg, tiff and webp)
• ClamAV (optional, Antivirus backend for Nextcloud)
• Fulltextsearch (optional)

And much more:

• Simple web interface included that enables easy installation and maintenance
• Easy updates included
• Update and backup notifications included
• Daily backups can be enabled from the AIO interface which also allows updating all containers, Nextcloud and its apps afterwards automatically
• Instance restore from backup archive via the AIO interface included (you only need the archive and the password in order to restore the whole instance on a new AIO instance)
• APCu as local cache
• Redis as distributed cache and for file locking
• Postgresql as database
• PHP-FPM with performance-optimized config (e.g. Opcache and JIT enabled by default)
• A+ security in Nextcloud security scan
• Ready to be used behind existing Reverse proxies
• Can be used behind Cloudflare Tunnel
• Ready for big file uploads up to 10 GB on public links, adjustable (logged in users can upload much bigger files using the webinterface or the mobile/desktop clients since chunking is used in that case)
• PHP and web server timeouts set to 3600s, adjustable (important for big file uploads)
• Defaults to a max of 512 MB RAM per PHP process, adjustable
• Automatic TLS included (by using Let's Encrypt)
• Brotli compression enabled by default for javascript, css and svg files which reduces Nextcloud load times
• HTTP/2 and HTTP/3 enabled
• "Pretty URLs" for Nextcloud are enabled by default (removes the index.php from all links)
• Video previews work out of the box and when Imaginary is enabled, many recent image formats as well!
• Only one domain and not multiple domains are required for everything to work (usually you would need to have one domain for each service which is much more complex)
• Adjustable location of Nextcloud's datadir (e.g. good for easy file-sharing with host system on Windows and MacOS)
• By default confined (good for security) but can allow access to additional storages in order to enable the usage of the local external storage feature
• Possibility included to adjust default installed Nextcloud apps
• Nextcloud installation is not read only - that means you can apply patches if you should need them (instead of having to wait for the next release for them getting applied)
• ffmpeg, smbclient and nodejs are included by default
• Possibility included to permanently add additional OS packages into the Nextcloud container without having to build your own Docker image
• Possibility included to permanently add additional PHP extensions into the Nextcloud container without having to build your own Docker image
• Possibility included to pass the needed device for hardware transcoding to the Nextcloud container
• Possibility included to store all docker related files on a separate drive
• Additional features can be added very easily
• LDAP can be used as user backend for Nextcloud
• Migration from any former Nextcloud installation to AIO is possible. See this documentation
• Fail2Ban can be added
• phpMyAdmin, Adminer or pgAdmin can be added
• Mail server can be added
• Nextcloud can be accessed locally via the domain
• Can be installed locally (if you don't want or cannot make the instance publicly reachable)
• IPv6-ready
• Can be used with Docker rootless (good for additional security)
• Runs on all platforms Docker supports (e.g. also on Windows and Macos)
• Included containers easy to debug by having the possibility to check their logs directly from the AIO interface
• Docker-compose ready
• Can be installed without a container having access to the docker socket
• Can be installed with Docker Swarm
• Can be installed with Kubernetes
• Almost all included containers Alpine Linux based (good for security and size)
• Many of the included containers run as non-root user (good for security)
• Many of the included containers have a read-only root-FS (good for security)
• Included containers run in its own docker network (good for security) and only really necessary ports are exposed on the host
• Multiple instances on one server are doable without having to deal with VMs
• Adjustable backup path from the AIO interface (good to put the backups e.g. on a different drive)
• Possibility included to also back up external Docker Volumes or Host paths (can be used for host backups)
• Borg backup can be completely managed from the AIO interface, including backup creation, backup restore, backup integrity check and integrity-repair
• Remote backups are indirectly possible
• Updates and backups can be run from an external script. See this documentation for a complete example.

Screenshots

First setup	After installation

How to use this?

The following instructions are meant for installations without a web server or reverse proxy (like Apache, Nginx, Cloudflare Tunnel and else) already being in place. If you want to run AIO behind a web server or reverse proxy (like Apache, Nginx, Cloudflare Tunnel and else), see the reverse proxy documentation. Also, the instructions below are especially meant for Linux. For macOS see this, for Windows see this and for Synology see this.

1. Install Docker on your Linux installation by following the official documentation: https://docs.docker.com/engine/install/#server. The easiest way is installing it by using the convenience script:

   curl -fsSL https://get.docker.com | sudo sh

2. If you need ipv6 support, you should enable it by following https://github.com/nextcloud/all-in-one/blob/main/docker-ipv6-support.md.

3. Run the command below in order to start the container on Linux and without a web server or reverse proxy (like Apache, Nginx, Cloudflare Tunnel and else) already in place:

   # For Linux and without a web server or reverse proxy (like Apache, Nginx, Cloudflare Tunnel and else) already in place:
   sudo docker run \
   --init \
   --sig-proxy=false \
   --name nextcloud-aio-mastercontainer \
   --restart always \
   --publish 80:80 \
   --publish 8080:8080 \
   --publish 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
   

   Explanation of the command

   • sudo docker run This command spins up a new docker container. Docker commands can optionally be used without sudo if the user is added to the docker group (this is not the same as docker rootless, see FAQ below).
   • --init This option makes sure that no zombie-processes are created, ever. See the Docker documentation.
   • --sig-proxy=false This option allows to exit the container shell that gets attached automatically when using docker run by using [CTRL] + [C] without shutting down the container.
   • --name nextcloud-aio-mastercontainer This is the name of the container. This line is not allowed to be changed, since mastercontainer updates would fail.
   • --restart always This is the "restart policy". always means that the container should always get started with the Docker daemon. See the Docker documentation for further detail about restart policies: https://docs.docker.com/config/containers/start-containers-automatically/
   • --publish 80:80 This means that port 80 of the container should get published on the host using port 80. It is used for getting valid certificates for the AIO interface if you want to use port 8443. It is not needed if you run AIO behind a web server or reverse proxy and can get removed in that case as you can simply use port 8080 for the AIO interface then.
   • --publish 8080:8080 This means that port 8080 of the container should get published on the host using port 8080. This port is used for the AIO interface and uses a self-signed certificate by default. You can also use a different host port if port 8080 is already used on your host, for example --publish 8081:8080 (only the first port can be changed for the host, the second port is for the container and must remain at 8080).
   • --publish 8443:8443 This means that port 8443 of the container should get published on the host using port 8443. If you publish port 80 and 8443 to the public internet, you can access the AIO interface via this port with a valid certificate. It is not needed if you run AIO behind a web server or reverse proxy and can get removed in that case as you can simply use port 8080 for the AIO interface then.
   • --volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config This means that the files that are created by the mastercontainer will be stored in a docker volume that is called nextcloud_aio_mastercontainer. This line is not allowed to be changed, since built-in backups would fail later on.
   • --volume /var/run/docker.sock:/var/run/docker.sock:ro The docker socket is mounted into the container which is used for spinning up all the other containers and for further features. It needs to be adjusted on Windows/macOS and on docker rootless. See the applicable documentation on this. If adjusting, don't forget to also set WATCHTOWER_DOCKER_SOCKET_PATH! If you dislike this, see https://github.com/nextcloud/all-in-one/tree/main/manual-install.
   • nextcloud/all-in-one:latest This is the docker container image that is used.
   • Further options can be set using environment variables, for example --env NEXTCLOUD_DATADIR="/mnt/ncdata" (This is an example for Linux. See this for other OS' and for an explanation of what this value does. This specific one needs to be specified upon the first startup if you want to change it to a specific path instead of the default Docker volume). To see explanations and examples for further variables (like changing the location of Nextcloud's datadir or mounting some locations as external storage into the Nextcloud container), read through this readme and look at the docker-compose file: https://github.com/nextcloud/all-in-one/blob/main/compose.yaml

   Note: You may be interested in adjusting Nextcloud’s datadir to store the files in a different location than the default docker volume. See this documentation on how to do it.

4. After the initial startup, you should be able to open the Nextcloud AIO Interface now on port 8080 of this server.
   E.g. https://ip.address.of.this.server:8080
   ⚠️ Important: do always use an ip-address if you access this port and not a domain as HSTS might block access to it later! (It is also expected that this port uses a self-signed certificate due to security concerns which you need to accept in your browser)
   
   If your firewall/router has port 80 and 8443 open/forwarded and you point a domain to your server, you can get a valid certificate automatically by opening the Nextcloud AIO Interface via:
   https://your-domain-that-points-to-this-server.tld:8443

5. Please do not forget to open port 3478/TCP and 3478/UDP in your firewall/router for the Talk container!

FAQ

How does it work?

Nextcloud AIO is inspired by projects like Portainer that manage the docker daemon by talking to it through the docker socket directly. This concept allows a user to install only one container with a single command that does the heavy lifting of creating and managing all containers that are needed in order to provide a Nextcloud installation with most features included. It also makes updating a breeze and is not bound to the host system (and its slow updates) anymore as everything is in containers. Additionally, it is very easy to handle from a user perspective because a simple interface for managing your Nextcloud AIO installation is provided.

Are reverse proxies supported?

Yes. Please refer to the following documentation on this: reverse-proxy.md

Which CPU architectures are supported?

You can check this on Linux by running: uname -m

• x86_64/x64/amd64
• aarch64/arm64/armv8 (Note: ClamAV is currently not supported on this CPU architecture)

Which ports are mandatory to be open in your firewall/router?

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

• 443/TCP for the Apache container
• 443/UDP if you want to enable http3 for the Apache container
• 3478/TCP and 3478/UDP 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://ip.address.of.this.server:8080/) ⚠️ Important: do always use an ip-address if you access this port and not a domain as HSTS might block access to it later! (It is also expected that this port uses a self-signed certificate due to security concerns which you need to accept in your browser)
• 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/forwarded in your firewall/router 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 Apache container later on and needs to be open/forwarded in your firewall/router
• 443/UDP: will be used by the Apache container later on and needs to be open/forwarded in your firewall/router if you want to enable http3
• 3478/TCP and 3478/UDP: will be used by the Turnserver inside the Talk container and needs to be open/forwarded in your firewall/router

How to run AIO on macOS?

On macOS, there is only one thing different in comparison to Linux: instead of using --volume /var/run/docker.sock:/var/run/docker.sock:ro, you need to use --volume /var/run/docker.sock.raw:/var/run/docker.sock:ro to run it after you installed Docker Desktop (and don't forget to enable ipv6 if you should need that). Apart from that it should work and behave the same like on Linux.

Also, you may be interested in adjusting Nextcloud's Datadir to store the files on the host system. See this documentation on how to do it.

How to run AIO on Windows?

On Windows, install Docker Desktop (and don't forget to enable ipv6 if you should need that) and run the following command in the command prompt:

docker run ^
--init ^
--sig-proxy=false ^
--name nextcloud-aio-mastercontainer ^
--restart always ^
--publish 80:80 ^
--publish 8080:8080 ^
--publish 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

Also, you may be interested in adjusting Nextcloud's Datadir to store the files on the host system. See this documentation on how to do it.

⚠️ Please note: Almost all commands in this project's documentation use sudo docker .... Since sudo is not available on Windows, you simply remove sudo from the commands and they should work.

How to run AIO on Synology DSM

On Synology, there are two things different in comparison to Linux: instead of using --volume /var/run/docker.sock:/var/run/docker.sock:ro, you need to use --volume /volume1/docker/docker.sock:/var/run/docker.sock:ro to run it. You also need to add --env WATCHTOWER_DOCKER_SOCKET_PATH="/volume1/docker/docker.sock"to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest). Apart from that it should work and behave the same like on Linux. Obviously the Synology Docker GUI will not work with that so you will need to either use SSH or create a user-defined script task in the task scheduler as the user 'root' in order to run the command.

⚠️ Please note: it is possible that the docker socket on your Synology is located in /var/run/docker.sock like the default on Linux. Then you can just use the Linux command without having to change anything - you will notice this when you try to start the container and it says that the bind mount failed. E.g. docker: Error response from daemon: Bind mount failed: '/volume1/docker/docker.sock' does not exists.

Also, you may be interested in adjusting Nextcloud's Datadir to store the files on the host system. See this documentation on how to do it.

You'll also need to adjust Synology's firewall, see below:

Click here to expand

The Synology DSM is vulnerable to attacks with it's open ports and login interfaces, which is why a firewall setup is always recommended. If a firewall is activated it is necessary to have exceptions for ports 80,443, the subnet of the docker bridge which includes the Nextcloud containers, your public static IP (if you don't use DDNS) and if applicable your NC-Talk ports 3478 TCP+UDP:

If you have the NAS setup on your local network (which is most often the case) you will need to setup the Synology DNS to be able to access Nextcloud from your network via its domain. Also don't forget to add the new DNS to your DHCP server and your fixed IP settings:

How to run AIO with Portainer?

The easiest way to run it with Portainer on Linux is to use Portainer's stacks feature and use this docker-compose file in order to start AIO correctly.

Can I run AIO on TrueNAS SCALE?

On TrueNAS SCALE, there are two ways to run AIO. The preferred one is to run AIO inside a VM. This is necessary since they do not expose the docker socket for containers on the host, you also cannot use docker-compose on it thus and it is also not possible to run custom helm-charts that are not explicitly written for TrueNAS SCALE.

Another but untested way is to install Portainer on your TrueNAS SCALE from here https://truecharts.org/charts/stable/portainer/installation-notes and add the Helm-chart repository https://nextcloud.github.io/all-in-one/ into Portainer by following https://docs.portainer.io/user/kubernetes/helm. More docs on AIOs Helm Chart are available here: https://github.com/nextcloud/all-in-one/tree/main/nextcloud-aio-helm-chart#nextcloud-aio-helm-chart.

Notes on Cloudflare (proxy/tunnel)

• Using Cloudflare Tunnel potentially slows down Nextcloud by a lot since local access via the configured domain is not possible since TLS proxying is in that case offloaded to Cloudflares infrastructure. You can fix this by setting up your own reverse proxy that handles TLS proxying locally.
• It is known that the domain validation may not work correctly behind Cloudflare since Cloudflare might block the validation attempt. You can simply skip it in that case by following: https://github.com/nextcloud/all-in-one#how-to-skip-the-domain-validation
• Make sure to disable Cloudflares Rocket Loader feature as otherwise Nextcloud's login prompt will not be shown.
• Cloudflare only supports uploading files up to 100 MB in the free plan, if you try to upload bigger files you will get an error (413 - Payload Too Large) if no chunking is used (e.g. for public uploads in the web, or if chunks are configured to be bigger than 100 MB in the clients or the web). If you need to upload bigger files, you need to disable the proxy option in your DNS settings, or you must use another proxy than Cloudflare tunnels. Both options will disable Cloudflare DDoS protection.
• If using Cloudflare Tunnel and the Nextcloud Desktop Client Set Chunking on Nextcloud Desktop Client
• Cloudflare only allows a max timeout of 100s for requests which is not configurable. This means that any server-side processing e.g. for assembling chunks for big files during upload that take longer than 100s will simply not work. See nextcloud/server#19223. If you need to upload big files reliably, you need to disable the proxy option in your DNS settings, or you must use another proxy than Cloudflare tunnels. Both options will disable Cloudflare DDoS protection.
• It is known that the in AIO included collabora (Nextcloud Office) does not work out of the box behind Cloudflare. To make it work, you need to add all Cloudflare IP-ranges to the wopi-allowlist in https://yourdomain.com/settings/admin/richdocuments
• Cloudflare Proxy might block the Turnserver for Nextcloud Talk from working correctly. You might want to disable Cloudflare Proxy thus. See #2463 (reply in thread)
• The built-in turn-server for Nextcloud Talk will not work behind Cloudflare Tunnel since it needs a separate port (by default 3478 or as chosen) available on the same domain. If you still want to use the feature, you will need to install your own turnserver or use a publicly available one and adjust and test your stun and turn settings in https://yourdomain.com/settings/admin/talk.
• If you get an error in Nextcloud's admin overview that the HSTS header is not set correctly, you might need to enable it in Cloudflare manually.
• If you are using AIO's built-in Reverse Proxy and don't use your own, then may the certificate issuing possibly not work out-of-the-box because Cloudflare might block the attempt. In that case you need to disable the Proxy feature at least temporarily in order to make it work. See #1101.

How to run Nextcloud behind a Cloudflare Tunnel?

Although it does not seems like it is the case but from AIO perspective a Cloudflare Tunnel works like a reverse proxy. So please follow the reverse proxy documentation where is documented how to make it run behind a Cloudflare Tunnel. However please see the caveats before proceeding.

Disrecommended VPS providers

• Older Strato VPS using Virtuozzo caused problems though ones from Q3 2023 and later should work. If your VPS has a /proc/user_beancounters file and a low numproc limit set in it your server will likely misbehave once it reaches this limit which is very quickly reached by AIO, see here.
• Hostingers VPS seem to miss a specific Kernel feature which is required for AIO to run correctly. See here.

Recommended VPS

In general recommended VPS are those that are KVM/non-virtualized as Docker should work best on them.

Note on storage options

• SD-cards are disrecommended for AIO since they cripple the performance and they are not meant for many write operations which is needed for the database and other parts
• SSD storage is recommended
• HDD storage should work as well but is of course much slower than SSD storage

How to get Nextcloud running using the ACME DNS-challenge?

You can install AIO in reverse proxy mode where is also documented how to get it running using the ACME DNS-challenge for getting a valid certificate for AIO. See the reverse proxy documentation. (Meant is the Caddy with ACME DNS-challenge section). Also see https://github.com/dani-garcia/vaultwarden/wiki/Running-a-private-vaultwarden-instance-with-Let%27s-Encrypt-certs#getting-a-custom-caddy-build for additional docs on this topic.

How to run Nextcloud locally?

If you do not want to open Nextcloud to the public internet, you may have a look at the following documentation how to set it up locally: local-instance.md

Can I run AIO offline or in an airgapped system?

No. This is not possible and will not be added due to multiple reasons: update checks, app installs via app-store, downloading additional docker images on demand and more.

Are self-signed certificates supported for Nextcloud?

No and they will not be. If you want to run it locally, without opening Nextcloud to the public internet, please have a look at the local instance documentation.

Can I use an ip-address for Nextcloud instead of a domain?

No and it will not be added. If you only want to run it locally, you may have a look at the following documentation: local-instance.md

Can I use AIO with multiple domains?

No and it will not be added. However you can use this feature in order to create multiple AIO instances, one for each domain.

Are other ports than the default 443 for Nextcloud supported?

No and they will not be. Please use a dedicated domain for Nextcloud and set it up correctly by following the reverse proxy documentation. If port 443 and/or 80 is blocked for you, you may use the a Cloudflare Tunnel if you want to publish it online. You could also use the ACME DNS-challenge to get a valid certificate. However in all cases the Nextcloud interface will redirect you to port 443.

Can I run Nextcloud in a subdirectory on my domain?

No and it will not be added. Please use a dedicated domain for Nextcloud and set it up correctly by following the reverse proxy documentation.

How can I access Nextcloud locally?

Please note that local access is not possible if you are running AIO behind Cloudflare Tunnel since TLS proxying is in that case offloaded to Cloudflares infrastructure. You can fix this by setting up your own reverse proxy that handles TLS proxying locally and will make the steps below work.

Please make sure that if you are running AIO behind a reverse proxy, that the reverse proxy is configured to use port 443 on the server that runs it. Otherwise the steps below will not work.

Now that this is out of the way, the recommended way how to access Nextcloud locally, is to set up a local dns-server like a pi-hole and set up a custom dns-record for that domain that points to the internal ip-adddress of your server that runs Nextcloud AIO. Below are some guides:

• https://www.howtogeek.com/devops/how-to-run-your-own-dns-server-on-your-local-network/
• https://help.nextcloud.com/t/need-help-to-configure-internal-access/156075/6
• https://howchoo.com/pi/pi-hole-setup together with https://web.archive.org/web/20221203223505/https://docs.callitkarma.me/posts/PiHole-Local-DNS/
• https://dockerlabs.collabnix.com/intermediate/networking/Configuring_DNS.html Apart from that there is now a community container that can be added to the AIO stack: https://github.com/nextcloud/all-in-one/tree/main/community-containers/pi-hole

How to skip the domain validation?

If you are completely sure that you've configured everything correctly and are not able to pass the domain validation, you may skip the domain validation by adding --env SKIP_DOMAIN_VALIDATION=true to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used).

How to resolve firewall problems with Fedora Linux, RHEL OS, CentOS, SUSE Linux and others?

It is known that Linux distros that use firewalld as their firewall daemon have problems with docker networks. In case the containers are not able to communicate with each other, you may change your firewalld to use the iptables backend by running:

sudo sed -i 's/FirewallBackend=nftables/FirewallBackend=iptables/g' /etc/firewalld/firewalld.conf
sudo systemctl restart firewalld docker

Afterwards it should work.

See https://dev.to/ozorest/fedora-32-how-to-solve-docker-internal-network-issue-22me for more details on this. This limitation is even mentioned on the official firewalld website: https://firewalld.org/#who-is-using-it

Are there known problems when SELinux is enabled?

Yes. If SELinux is enabled, you might need to add the --security-opt label:disable option to the docker run command of the mastercontainer in order to allow it to access the docker socket (or security_opt: ["label:disable"] in compose.yaml). See #485

How to run occ commands?

Simply run the following: sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ your-command. Of course your-command needs to be exchanged with the command that you want to run.

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

Simply run the following command: sudo docker exec --user www-data 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, US and GB. See this list for more codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements

How to run multiple AIO instances on one server?

See multiple-instances.md for some documentation on this.

Bruteforce protection FAQ

Nextcloud features a built-in bruteforce protection which may get triggered and will block an ip-address or disable a user. You can unblock an ip-address by running sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ security:bruteforce:reset <ip-address> and enable a disabled user by running sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ user:enable <name of user>. See https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html#security for further information.

Update policy

This project values stability over new features. That means that when a new major Nextcloud update gets introduced, we will wait at least until the first patch release, e.g. 24.0.1 is out before upgrading to it. Also we will wait with the upgrade until all important apps are compatible with the new major version. Minor or patch releases for Nextcloud and all dependencies as well as all containers will be updated to new versions as soon as possible but we try to give all updates first a good test round before pushing them. That means that it can take around 2 weeks before new updates reach the latest channel. If you want to help testing, you can switch to the beta channel by following this documentation which will also give you the updates earlier.

How to switch the channel?

You can switch to a different channel like e.g. the beta channel or from the beta channel back to the latest channel by stopping the mastercontainer, removing it (no data will be lost) and recreating the container using the same command that you used initially to create the mastercontainer. You simply need to change the last line nextcloud/all-in-one:latest to nextcloud/all-in-one:beta and vice versa.

How to update the containers?

If we push new containers to latest, you will see in the AIO interface below the containers section that new container updates were found. In this case, just press Stop containers and Start and update containers in order to update the containers. The mastercontainer has its own update procedure though. See below. And don't forget to back up the current state of your instance using the built-in backup solution before starting the containers again! Otherwise you won't be able to restore your instance easily if something should break during the update.

If a new Mastercontainer update was found, you'll see an additional section below the containers section which shows that a mastercontainer update is available. If so, you can simply press on the button to update the container.

Additionally, there is a cronjob that runs once a day that checks for container and mastercontainer updates and sends a notification to all Nextcloud admins if a new update was found.

How to easily log in to the AIO interface?

If your Nextcloud is running and you are logged in as admin in your Nextcloud, you can easily log in to the AIO interface by opening https://yourdomain.tld/settings/admin/overview which will show a button on top that enables you to log in to the AIO interface by just clicking on this button. Note: You can change the domain/ip-address/port of the button by simply stopping the containers, visiting the AIO interface from the correct and desired domain/ip-address/port and clicking once on Start containers.

How to change the domain?

⚠️ Please note: Editing the configuration.json manually and making a mistake may break your instance so please create a backup first!

If you set up a new AIO instance, you need to enter a domain. Currently there is no way to change this domain afterwards from the AIO interface. So in order to change it, you need to edit the configuration.json manually using sudo docker run -it --rm --volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config:rw alpine sh -c "apk add --no-cache nano && nano /mnt/docker-aio-config/data/configuration.json", substitute each occurrence of your old domain with your new domain and save and write out the file. Afterwards restart your containers from the AIO interface and everything should work as expected if the new domain is correctly configured.
If you are running AIO behind a web server or reverse proxy (like Apache, Nginx, Cloudflare Tunnel and else), you need to obviously also change the domain in your reverse proxy config.

Additionally, after restarting the containers, you need to open the admin settings and update some values manually that cannot be changed automatically. Here is a list of some known places:

• https://your-nc-domain.com/settings/admin/talk for Turn/Stun server and Signaling Server if you enabled Talk via the AIO interface
• https://your-nc-domain.com/settings/admin/theming for the theming URL
• https://your-nc-domain.com/settings/admin/app_api for the deploy daemon if you enabled the App API via the AIO interface

How to properly reset the instance?

If something goes unexpected routes during the initial installation, you might want to reset the AIO installation to be able to start from scratch.

Please note: if you already have it running and have data on your instance, you should not follow these instructions as it will delete all data that is coupled to your AIO instance.

Here is how to reset the AIO instance properly:

1. Stop all containers if they are running from the AIO interface
2. Stop the mastercontainer with sudo docker stop nextcloud-aio-mastercontainer
3. If the domaincheck container is still running, stop it with sudo docker stop nextcloud-aio-domaincheck
4. Check that no AIO containers are running anymore by running sudo docker ps --format {{.Names}}. If no nextcloud-aio containers are listed, you can proceed with the steps below. If there should be some, you will need to stop them with sudo docker stop <container_name> until no one is listed anymore.
5. Check which containers are stopped: sudo docker ps --filter "status=exited"
6. Now remove all these stopped containers with sudo docker container prune
7. Delete the docker network with sudo docker network rm nextcloud-aio
8. Check which volumes are dangling with sudo docker volume ls --filter "dangling=true"
9. Now remove all these dangling volumes: sudo docker volume prune --filter all=1 (on Windows you might need to remove some volumes afterwards manually with docker volume rm nextcloud_aio_backupdir, docker volume rm nextcloud_aio_nextcloud_datadir).
10. If you've configured NEXTCLOUD_DATADIR to a path on your host instead of the default volume, you need to clean that up as well. (E.g. by simply deleting the directory).
11. Make sure that no volumes are remaining with sudo docker volume ls --format {{.Name}}. If no nextcloud-aio volumes are listed, you can proceed with the steps below. If there should be some, you will need to stop them with sudo docker volume rm <volume_name> until no one is listed anymore.
12. Optional: You can remove all docker images with sudo docker image prune -a.
13. And you are done! Now feel free to start over with the recommended docker run command!

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. By using this tool, backups are incremental, differential, compressed and encrypted – so only the first backup will take a while. Further backups should be fast as only changes are taken into account.

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.

The restore process should be pretty fast as rsync is used to restore the chosen backup which only transfers changed files and deletes additional ones.

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

How to do the above step for step

1. Mount an external/backup HDD to the host OS using the built-in functionality or udev rules or whatever way you prefer. (E.g. follow this video: https://www.youtube.com/watch?v=2lSyX4D3v_s) and mount the drive in best case in /mnt/backup.
2. If not already done, fire up the docker container and set up Nextcloud as per the guide.
3. Now open the AIO interface.
4. Under backup section, add your external disk mountpoint as backup directory, e.g. /mnt/backup.
5. Click on Create Backup which should create the first backup on the external disk.

Backups can be created and restored in the AIO interface using the buttons Create Backup and Restore selected 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.

Daily backups can get enabled after the initial backup is done. Enabling this also allows to enable an option that allows to update all containers, Nextcloud and its apps automatically.

Be aware that this solution does not back up files and folders that are mounted into Nextcloud using the external storage app - but you can add further Docker volumes and host paths that you want to back up after the initial backup is done.

---

What is getting backed up by AIO's backup solution?

Backed up will get all important data of your Nextcloud AIO instance like the database, your files and configuration files of the mastercontainer and else. Files and folders that are mounted into Nextcloud using the external storage app are not getting backed up. There is currently no way to exclude the data directory because it would require hacks like running files:scan and would make the backup solution much more unreliable (since the database and your files/folders need to stay in sync). If you still don't want your datadirectory to be backed up, see https://github.com/nextcloud/all-in-one#how-to-enable-automatic-updates-without-creating-a-backup-beforehand for options (there is a hint what needs to be backed up in which order).

How to adjust borgs retention policy?

The built-in borg-based backup solution has by default a retention policy of --keep-within=7d --keep-weekly=4 --keep-monthly=6. See https://borgbackup.readthedocs.io/en/stable/usage/prune.html for what these values mean. You can adjust the retention policy by providing --env BORG_RETENTION_POLICY="--keep-within=7d --keep-weekly=4 --keep-monthly=6" to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and customize the value to your fitting. ⚠️ Please make sure that this value is valid, otherwise backup pruning will bug out!

Are remote borg backups supported?

Not directly but you have multiple options to achieve this:

• Mount a network FS like SSHFS, SMB or NFS in the directory that you enter in AIO as backup directory
• Use rsync or rclone for syncing the borg backup archive that AIO creates locally to a remote target (make sure to lock the backup archive correctly before starting the sync; search for "aio-lockfile"; you can find a local example script here: https://github.com/nextcloud/all-in-one#sync-the-backup-regularly-to-another-drive)
• You can find a well written guide that uses rclone and e.g. BorgBase for remote backups here: #2247
• Here is another one that utilizes borgmatic and BorgBase for remote backups: #4391
• create your own backup solution using a script and borg, borgmatic or any other to backup tool for backing up to a remote target (make sure to stop and start the AIO containers correctly following https://github.com/nextcloud/all-in-one#how-to-enable-automatic-updates-without-creating-a-backup-beforehand)

---

Failure of the backup container in LXC containers

If you are running AIO in a LXC container, you need to make sure that FUSE is enabled in the LXC container settings. Also, if using Alpine Linux as host OS, make sure to add fuse via apk add fuse. Otherwise the backup container will not be able to start as FUSE is required for it to work.

---

How to create the backup volume on Windows?

As stated in the AIO interface, it is possible to use a docker volume as backup target. Before you can use that, you need to create it first. Here is an example how to create one on Windows:

docker volume create ^
--driver local ^
--name nextcloud_aio_backupdir ^
-o device="/host_mnt/e/your/backup/path" ^
-o type="none" ^
-o o="bind"

In this example, it would mount E:\your\backup\path into the volume so for a different location you need to adjust /host_mnt/e/your/backup/path accordingly. Afterwards enter nextcloud_aio_backupdir in the AIO interface as backup location.

---

Pro-tip: Backup archives access

You can open the BorgBackup archives on your host by following these steps:
(instructions for Ubuntu Desktop)

# Install borgbackup on the host
sudo apt update && sudo apt install borgbackup

# Mount the archives to /tmp/borg (if you are using the default backup location /mnt/backup/borg)
sudo mkdir -p /tmp/borg && sudo borg mount "/mnt/backup/borg" /tmp/borg

# After entering your repository key successfully, you should be able to access all archives in /tmp/borg
# You can now do whatever you want by syncing them to a different place using rsync or doing other things
# E.g. you can open the file manager on that location by running:
xhost +si:localuser:root && sudo nautilus /tmp/borg

# When you are done, simply close the file manager and run the following command to unmount the backup archives:
sudo umount /tmp/borg

---

Delete backup archives manually

You can delete BorgBackup archives on your host manually by following these steps:
(instructions for Debian based OS' like Ubuntu)

# Install borgbackup on the host
sudo apt update && sudo apt install borgbackup

# List all archives (if you are using the default backup location /mnt/backup/borg)
sudo borg list "/mnt/backup/borg"

# After entering your repository key successfully, you should now see a list of all backup archives
# An example backup archive might be called 20220223_174237-nextcloud-aio
# Then you can simply delete the archive with:
sudo borg delete --stats --progress "/mnt/backup/borg::20220223_174237-nextcloud-aio"

# If borg 1.2.0 or higher is installed, you then need to run borg compact in order to clean up the freed space
sudo borg --version
# If version number of the command above is higher than 1.2.0 you need to run the command below:
sudo borg compact "/mnt/backup/borg"

After doing so, make sure to update the backup archives list in the AIO interface!
You can do so by clicking on the Check backup integrity button or Create backup button.

---

Sync the backup regularly to another drive

For increased backup security, you might consider syncing the backup repository regularly to another drive.

To do that, first add the drive to /etc/fstab so that it is able to get automatically mounted and then create a script that does all the things automatically. Here is an example for such a script:

Click here to expand

#!/bin/bash

# Please modify all variables below to your needings:
SOURCE_DIRECTORY="/mnt/backup/borg"
DRIVE_MOUNTPOINT="/mnt/backup-drive"
TARGET_DIRECTORY="/mnt/backup-drive/borg"

########################################
# Please do NOT modify anything below! #
########################################

if [ "$EUID" -ne 0 ]; then 
    echo "Please run as root"
    exit 1
fi

if ! [ -d "$SOURCE_DIRECTORY" ]; then
    echo "The source directory does not exist."
    exit 1
fi

if [ -z "$(ls -A "$SOURCE_DIRECTORY/")" ]; then
    echo "The source directory is empty which is not allowed."
    exit 1
fi

if ! [ -d "$DRIVE_MOUNTPOINT" ]; then
    echo "The drive mountpoint must be an existing directory"
    exit 1
fi

if ! grep -q "$DRIVE_MOUNTPOINT" /etc/fstab; then
    echo "Could not find the drive mountpoint in the fstab file. Did you add it there?"
    exit 1
fi

if ! mountpoint -q "$DRIVE_MOUNTPOINT"; then
    mount "$DRIVE_MOUNTPOINT"
    if ! mountpoint -q "$DRIVE_MOUNTPOINT"; then
        echo "Could not mount the drive. Is it connected?"
        exit 1
    fi
fi

if [ -f "$SOURCE_DIRECTORY/lock.roster" ]; then
    echo "Cannot run the script as the backup archive is currently changed. Please try again later."
    exit 1
fi

mkdir -p "$TARGET_DIRECTORY"
if ! [ -d "$TARGET_DIRECTORY" ]; then
    echo "Could not create target directory"
    exit 1
fi

if [ -f "$SOURCE_DIRECTORY/aio-lockfile" ]; then
    echo "Not continuing because aio-lockfile already exists."
    exit 1
fi

touch "$SOURCE_DIRECTORY/aio-lockfile"

if ! rsync --stats --archive --human-readable --delete "$SOURCE_DIRECTORY/" "$TARGET_DIRECTORY"; then
    echo "Failed to sync the backup repository to the target directory."
    exit 1
fi

rm "$SOURCE_DIRECTORY/aio-lockfile"
rm "$TARGET_DIRECTORY/aio-lockfile"

umount "$DRIVE_MOUNTPOINT"

if docker ps --format "{{.Names}}" | grep "^nextcloud-aio-nextcloud$"; then
    docker exec -it nextcloud-aio-nextcloud bash /notify.sh "Rsync backup successful!" "Synced the backup repository successfully."
else
    echo "Synced the backup repository successfully."
fi

You can simply copy and paste the script into a file e.g. named backup-script.sh e.g. here: /root/backup-script.sh. Do not forget to modify the variables to your requirements!

Afterwards apply the correct permissions with sudo chown root:root /root/backup-script.sh and sudo chmod 700 /root/backup-script.sh. Then you can create a cronjob that runs e.g. at 20:00 each week on Sundays like this:

1. Open the cronjob with sudo crontab -u root -e (and choose your editor of choice if not already done. I'd recommend nano).
2. Add the following new line to the crontab if not already present: 0 20 * * 7 /root/backup-script.sh which will run the script at 20:00 on Sundays each week.
3. save and close the crontab (when using nano are the shortcuts for this Ctrl + o -> Enter and close the editor with Ctrl + x).

How to stop/start/update containers or trigger the daily backup from a script externally?

⚠️⚠️⚠️ Warning: The below script will only work after the initial setup of AIO. So you will always need to first visit the AIO interface, type in your domain and start the containers the first time or restore an older AIO instance from its borg backup before you can use the script.

You can do so by running the /daily-backup.sh script that is stored in the mastercontainer. It accepts the following environmental varilables:

• AUTOMATIC_UPDATES if set to 1, it will automatically stop the containers, update them and start them including the mastercontainer. If the mastercontainer gets updated, this script's execution will stop as soon as the mastercontainer gets stopped. You can then wait until it is started again and run the script with this flag again in order to update all containers correctly afterwards.
• DAILY_BACKUP if set to 1, it will automatically stop the containers and create a backup. If you want to start them again afterwards, you may have a look at the START_CONTAINERS option.
• START_CONTAINERS if set to 1, it will automatically start the containers without updating them.
• STOP_CONTAINERS if set to 1, it will automatically stop the containers.
• CHECK_BACKUP if set to 1, it will start the backup check. This is not allowed to be enabled at the same time like DAILY_BACKUP. Please be aware that this option is non-blocking which means that the backup check is not done when the process is finished since it only start the borgbackup container with the correct configuration.

One example for this would be sudo docker exec -it --env DAILY_BACKUP=1 nextcloud-aio-mastercontainer /daily-backup.sh, which you can run via a cronjob or put it in a script.

⚠️ Please note that none of the option returns error codes. So you need to check for the correct result yourself.

How to disable the backup section?

If you already have a backup solution in place, you may want to hide the backup section. You can do so by adding --env AIO_DISABLE_BACKUP_SECTION=true to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used).

How to change the default location of Nextcloud's Datadir?

⚠️⚠️⚠️ Warning: Do not set or adjust this value after the initial Nextcloud installation is done! If you still want to do it afterwards, see this on how to do it.

You can configure the Nextcloud container to use a specific directory on your host as data directory. You can do so by adding the environmental variable NEXTCLOUD_DATADIR to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used). Allowed values for that variable are strings that start with / and are not equal to /. The chosen directory or volume will then be mounted to /mnt/ncdata inside the container.

• An example for Linux is --env NEXTCLOUD_DATADIR="/mnt/ncdata". ⚠️ Please note: If you should be using an external BTRFS drive that is mounted to /mnt/ncdata, make sure to choose a subfolder like e.g. /mnt/ncdata/nextcloud as datadir, since the root folder is not suited as datadir in that case. See #2696.
• On macOS it might be --env NEXTCLOUD_DATADIR="/var/nextcloud-data"
• For Synology it may be --env NEXTCLOUD_DATADIR="/volume1/docker/nextcloud/data".
• On Windows it might be --env NEXTCLOUD_DATADIR="/run/desktop/mnt/host/c/ncdata". (This path is equivalent to C:\ncdata on your Windows host so you need to translate the path accordingly. Hint: the path that you enter needs to start with /run/desktop/mnt/host/. Append to that the exact location on your windows host, e.g. c/ncdata which is equivalent to C:\ncdata.) ⚠️ Please note: This does not work with external drives like USB or network drives and only with internal drives like SATA or NVME drives.
• Another option is to provide a specific volume name here with: --env NEXTCLOUD_DATADIR="nextcloud_aio_nextcloud_datadir". This volume needs to be created beforehand manually by you in order to be able to use it. e.g. on Windows with:

  docker volume create ^
  --driver local ^
  --name nextcloud_aio_nextcloud_datadir ^
  -o device="/host_mnt/e/your/data/path" ^
  -o type="none" ^
  -o o="bind"
  

  In this example, it would mount E:\your\data\path into the volume so for a different location you need to adjust /host_mnt/e/your/data/path accordingly.

Can I use a CIFS/SMB share as Nextcloud's datadir?

Sure. Add this to the /etc/fstab file:
<your-storage-host-and-subpath> <your-mount-dir> cifs rw,mfsymlinks,seal,credentials=<your-credentials-file>,uid=33,gid=0,file_mode=0770,dir_mode=0770 0 0
(Of course you need to modify <your-storage-host-and-subpath>, <your-mount-dir> and <your-credentials-file> for your specific case.)

One example could look like this:
//your-storage-host/subpath /mnt/storagebox cifs rw,mfsymlinks,seal,credentials=/etc/storage-credentials,uid=33,gid=0,file_mode=0770,dir_mode=0770 0 0
and add into /etc/storage-credentials:

username=<smb/cifs username>
password=<password>

(Of course you need to modify <smb/cifs username> and <password> for your specific case.)

Now you can use /mnt/storagebox as Nextcloud's datadir like described in the section above above this one.

How to allow the Nextcloud container to access directories on the host?

By default, the Nextcloud container is confined and cannot access directories on the host OS. You might want to change this when you are planning to use local external storage in Nextcloud to store some files outside the data directory and can do so by adding the environmental variable NEXTCLOUD_MOUNT to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used). Allowed values for that variable are strings that start with / and are not equal to /.

• Two examples for Linux are --env NEXTCLOUD_MOUNT="/mnt/" and --env NEXTCLOUD_MOUNT="/media/".
• On macOS it might be --env NEXTCLOUD_MOUNT="/Volumes/your_drive/"
• For Synology it may be --env NEXTCLOUD_MOUNT="/volume1/".
• On Windows it might be --env NEXTCLOUD_MOUNT="/run/desktop/mnt/host/d/your-folder/". (This path is equivalent to D:\your-folder on your Windows host so you need to translate the path accordingly. Hint: the path that you enter needs to start with /run/desktop/mnt/host/. Append to that the exact location on your windows host, e.g. d/your-folder/ which is equivalent to D:\your-folder.) ⚠️ Please note: This does not work with external drives like USB or network drives and only with internal drives like SATA or NVME drives.

After using this option, please make sure to apply the correct permissions to the directories that you want to use in Nextcloud. E.g. sudo chown -R 33:0 /mnt/your-drive-mountpoint and sudo chmod -R 750 /mnt/your-drive-mountpoint should make it work on Linux when you have used --env NEXTCLOUD_MOUNT="/mnt/". On Windows you could do this e.g. with docker exec -it nextcloud-aio-nextcloud chown -R 33:0 /run/desktop/mnt/host/d/your-folder/ and docker exec -it nextcloud-aio-nextcloud chmod -R 750 /run/desktop/mnt/host/d/your-folder/.

You can then navigate to the apps management page, activate the external storage app, navigate to https://your-nc-domain.com/settings/admin/externalstorages and add a local external storage directory that will be accessible inside the container at the same place that you've entered. E.g. /mnt/your-drive-mountpoint will be mounted to /mnt/your-drive-mountpoint inside the container, etc.

Be aware though that these locations will not be covered by the built-in backup solution - but you can add further Docker volumes and host paths that you want to back up after the initial backup is done.

Please note: If you can't see the type "local storage" in the external storage admin options, a restart of the containers from the AIO interface may be required.

How to adjust the Talk port?

By default will the talk container use port 3478/UDP and 3478/TCP for connections. You can adjust the port by adding e.g. --env TALK_PORT=3478 to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and adjusting the port to your desired value. Best is to use a port over 1024, so e.g. 3479 to not run into this: #2517

How to adjust the upload limit for Nextcloud?

By default, public uploads to Nextcloud are limited to a max of 10G (logged in users can upload much bigger files using the webinterface or the mobile/desktop clients, since chunking is used in that case). You can adjust the upload limit by providing --env NEXTCLOUD_UPLOAD_LIMIT=10G to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and customize the value to your fitting. It must start with a number and end with G e.g. 10G.

How to adjust the max execution time for Nextcloud?

By default, uploads to Nextcloud are limited to a max of 3600s. You can adjust the upload time limit by providing --env NEXTCLOUD_MAX_TIME=3600 to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and customize the value to your fitting. It must be a number e.g. 3600.

How to adjust the PHP memory limit for Nextcloud?

By default, each PHP process in the Nextcloud container is limited to a max of 512 MB. You can adjust the memory limit by providing --env NEXTCLOUD_MEMORY_LIMIT=512M to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and customize the value to your fitting. It must start with a number and end with M e.g. 1024M.

What can I do to fix the internal or reserved ip-address error?

If you get an error during the domain validation which states that your ip-address is an internal or reserved ip-address, you can fix this by first making sure that your domain indeed has the correct public ip-address that points to the server and then adding --add-host yourdomain.com:<public-ip-address> to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) which will allow the domain validation to work correctly. And so that you know: even if the A record of your domain should change over time, this is no problem since the mastercontainer will not make any attempt to access the chosen domain after the initial domain validation.

Can I run this with Docker swarm?

Yes. For that to work, you need to use and follow the manual-install documentation.

Can I run this with Kubernetes?

Yes. For that to work, you need to use and follow the helm-chart documentation.

How to run this with Docker rootless?

You can run AIO also with docker rootless. How to do this is documented here: docker-rootless.md

Can I run this with Podman instead of Docker?

Since Podman is not 100% compatible with the Docker API, Podman is not supported (since that would add yet another platform where the maintainer would need to test on). However you can use and follow the manual-install documentation to get AIO's containers running with Podman or use Docker rootless, as described in the above section. Also there is this now: #3487

How to change the Nextcloud apps that are installed on the first startup?

You might want to adjust the Nextcloud apps that are installed upon the first startup of the Nextcloud container. You can do so by adding --env NEXTCLOUD_STARTUP_APPS="deck twofactor_totp tasks calendar contacts notes" to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and customize the value to your fitting. It must be a string with small letters a-z, 0-9, spaces and hyphens or '_'. You can disable shipped and by default enabled apps by adding a hyphen in front of the appid. E.g. -contactsinteraction.

How to add OS packages permanently to the Nextcloud container?

Some Nextcloud apps require additional external dependencies that must be bundled within Nextcloud container in order to work correctly. As we cannot put each and every dependency for all apps into the container - as this would make the project quickly unmaintainable - there is an official way in which you can add additional dependencies into the Nextcloud container. However note that doing this is disrecommended since we do not test Nextcloud apps that require external dependencies.

You can do so by adding --env NEXTCLOUD_ADDITIONAL_APKS="imagemagick dependency2 dependency3" to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and customize the value to your fitting. It must be a string with small letters a-z, digits 0-9, spaces, dots and hyphens or '_'. You can find available packages here: https://pkgs.alpinelinux.org/packages?branch=v3.19. By default imagemagick is added. If you want to keep it, you need to specify it as well.

How to add PHP extensions permanently to the Nextcloud container?

Some Nextcloud apps require additional php extensions that must be bundled within Nextcloud container in order to work correctly. As we cannot put each and every dependency for all apps into the container - as this would make the project quickly unmaintainable - there is an official way in which you can add additional php extensions into the Nextcloud container. However note that doing this is disrecommended since we do not test Nextcloud apps that require additional php extensions.

You can do so by adding --env NEXTCLOUD_ADDITIONAL_PHP_EXTENSIONS="imagick extension1 extension2" to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) and customize the value to your fitting. It must be a string with small letters a-z, digits 0-9, spaces, dots and hyphens or '_'. You can find available extensions here: https://pecl.php.net/packages.php. By default imagick is added. If you want to keep it, you need to specify it as well.

What about the pdlib PHP extension for the facerecognition app?

The facerecognition app requires the pdlib PHP extension to be installed. Unfortunately, it is not available on PECL nor via PHP core, so there is no way to add this into AIO currently. However you can use this community container in order to run facerecognition.

How to enable hardware-transcoding for Nextcloud?

⚠️⚠️⚠️ Warning: this only works if the /dev/dri device is present on the host! If it does not exists on your host, don't proceed as otherwise the Nextcloud container will fail to start! If you are unsure about this, better do not proceed with the instructions below.

The memories app allows to enable hardware transcoding for videos. In order to use that, you need to add --env NEXTCLOUD_ENABLE_DRI_DEVICE=true to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used) which will mount the /dev/dri device into the container. There is now a community container which allows to easily add the transcoding container of Memories to AIO: https://github.com/nextcloud/all-in-one/tree/main/community-containers/memories

How to keep disabled apps?

In certain situations you might want to keep Nextcloud apps that are disabled in the AIO interface and not uninstall them if they should be installed in Nextcloud. You can do so by adding --env NEXTCLOUD_KEEP_DISABLED_APPS=true to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used). ⚠️⚠️⚠️ Warning doing this might cause unintended problems in Nextcloud if an app that requires an external dependency is still installed but the external dependency not for example.

Huge docker logs

If you should run into issues with huge docker logs, you can adjust the log size by following https://docs.docker.com/config/containers/logging/local/#usage. However for the included AIO containers, this should usually not be needed because almost all of them have the log level set to warn so they should not produce many logs.

Access/Edit Nextcloud files/folders manually

The files and folders that you add to Nextcloud are by default stored in the following docker directory: nextcloud_aio_nextcloud:/mnt/ncdata/ (usually /var/lib/docker/volumes/nextcloud_aio_nextcloud_data/_data/ on linux host systems). If needed, you can modify/add/delete files/folders there but ATTENTION: be very careful when doing so because you might corrupt your AIO installation! Best is to create a backup using the built-in backup solution before editing/changing files/folders in there because you will then be able to restore your instance to the backed up state.

After you are done modifying/adding/deleting files/folders, don't forget to apply the correct permissions by running: sudo docker exec nextcloud-aio-nextcloud chown -R 33:0 /mnt/ncdata/ and sudo docker exec nextcloud-aio-nextcloud chmod -R 750 /mnt/ncdata/ and rescan the files with sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ files:scan --all.

How to store the files/installation on a separate drive?

You can move the whole docker library and all its files including all Nextcloud AIO files and folders to a separate drive by first mounting the drive in the host OS (NTFS is not supported and ext4 is recommended as FS) and then following this tutorial: https://www.guguweb.com/2019/02/07/how-to-move-docker-data-directory-to-another-location-on-ubuntu/
(Of course docker needs to be installed first for this to work.)

⚠️ If you encounter errors from richdocuments in your Nextcloud logs, check in your Collabora container if the message "Capabilities are not set for the coolforkit program." appears. If so, follow these steps:

1. Stop all the containers from the AIO Interface.
2. Go to your terminal and delete the Collabora container (docker rm nextcloud-aio-collabora) AND the Collabora image (docker image rm nextcloud/aio-collabora).
3. You might also want to prune your Docker (docker system prune) (no data will be lost).
4. Restart your containers from the AIO Interface.

This should solve the problem.

How to edit Nextclouds config.php file with a texteditor?

You can edit Nextclouds config.php file directly from the host with your favorite text editor. E.g. like this: sudo docker run -it --rm --volume nextcloud_aio_nextcloud:/var/www/html:rw alpine sh -c "apk add --no-cache nano && nano /var/www/html/config/config.php". Make sure to not break the file though which might corrupt your Nextcloud instance otherwise. In best case, create a backup using the built-in backup solution before editing the file.

How to change default files by creating a custom skeleton directory?

All users see a set of default files and folders as dictated by Nextcloud's configuration. To change these default files and folders a custom skeleton directory must first be created; this can be accomplished by copying your skeleton files sudo docker cp --follow-link /path/to/nextcloud/skeleton/ nextcloud-aio-nextcloud:/mnt/ncdata/skeleton/, applying the correct permissions with sudo docker exec nextcloud-aio-nextcloud chown -R 33:0 /mnt/ncdata/skeleton/ and sudo docker exec nextcloud-aio-nextcloud chmod -R 750 /mnt/ncdata/skeleton/ and setting the skeleton directory option with sudo docker exec --user www-data -it nextcloud-aio-nextcloud php occ config:system:set skeletondirectory --value="/mnt/ncdata/skeleton". Further information is available in the Nextcloud documentation on configuration parameters for the skeleton directory.

Fail2ban

You can configure your server to block certain ip-addresses using fail2ban as bruteforce protection. Here is how to set it up: https://docs.nextcloud.com/server/stable/admin_manual/installation/harden_server.html#setup-fail2ban. The logpath of AIO is by default /var/lib/docker/volumes/nextcloud_aio_nextcloud/_data/data/nextcloud.log. Do not forget to add chain=DOCKER-USER to your nextcloud jail config (nextcloud.local) otherwise the nextcloud service running on docker will still be accessible even if the IP is banned. Also, you may change the blocked ports to cover all AIO ports: by default 80,443,8080,8443,3478 (see this). Apart from that there is now a community container that can be added to the AIO stack: https://github.com/nextcloud/all-in-one/tree/main/community-containers/fail2ban

LDAP

It is possible to connect to an existing LDAP server. You need to make sure that the LDAP server is reachable from the Nextcloud container. Then you can enable the LDAP app and configure LDAP in Nextcloud manually. If you don't have a LDAP server yet, recommended is to use this docker container: https://hub.docker.com/r/nitnelave/lldap. Make sure here as well that Nextcloud can talk to the LDAP server. The easiest way is by adding the LDAP docker container to the docker network nextcloud-aio. Then you can connect to the LDAP container by its name from the Nextcloud container. There is now a community container which allows to easily add LLDAP to AIO: https://github.com/nextcloud/all-in-one/tree/main/community-containers/lldap

Netdata

Netdata allows you to monitor your server using a GUI. You can install it by following https://learn.netdata.cloud/docs/agent/packaging/docker#create-a-new-netdata-agent-container. Apart from that there is now a way for the community to add containers: #392 (comment)

USER_SQL

If you want to use the user_sql app, the easiest way is to create an additional database container and add it to the docker network nextcloud-aio. Then the Nextcloud container should be able to talk to the database container using its name.

phpMyAdmin, Adminer or pgAdmin

It is possible to install any of these to get a GUI for your AIO database. The pgAdmin container is recommended. You can get some docs on it here: https://www.pgadmin.org/docs/pgadmin4/latest/container_deployment.html. For the container to connect to the aio-database, you need to connect the container to the docker network nextcloud-aio and use nextcloud-aio-database as database host, oc_nextcloud as database username and the password that you get when running sudo docker exec nextcloud-aio-nextcloud grep dbpassword config/config.php as the password. Apart from that there is now a way for the community to add containers: #3061 (comment)

Mail server

You can configure one yourself by using either of these four recommended projects: Docker Mailserver, Mailu, Maddy Mail Server, Mailcow or Stalwart. There is now a community container which allows to easily add Stalwart Mail server to AIO: https://github.com/nextcloud/all-in-one/tree/main/community-containers/stalwart

How to migrate from an already existing Nextcloud installation to Nextcloud AIO?

Please see the following documentation on this: migration.md

Requirements for integrating new containers

For integrating new containers, they must pass specific requirements for being considered to get integrated in AIO itself. Even if not considered, we may add some documentation on it. Also there is this now: https://github.com/nextcloud/all-in-one/tree/main/community-containers#community-containers

What are the requirements?

1. New containers must be related to Nextcloud. Related means that there must be a feature in Nextcloud that gets added by adding this container.
2. It must be optionally installable. Disabling and enabling the container from the AIO interface must work and must not produce any unexpected side-effects.
3. The feature that gets added into Nextcloud by adding the container must be maintained by the Nextcloud GmbH.
4. It must be possible to run the container without big quirks inside docker containers. Big quirks means e.g. needing to change the capabilities or security options.
5. The container should not mount directories from the host into the container: only docker volumes should be used.
6. The container must be usable by more than 90% of the users (e.g. not too high system requirements and such)
7. No additional setup should be needed after adding the container - it should work completely out of the box.
8. If the container requires being exposed, only subfolders are supported. So the container should not require its own (sub-)domain and must be able to run in a subfolder.

How to trust user-defined Certification Authorities (CA)?

For some applications it might be necessary to establish a secure connection to another host/server which is using a certificate issued by a Certification Authority that is not trusted out of the box. An example could be configuring LDAPS against a domain controller (Active Directory or Samba-based) of an organization.

You can make the Nextcloud container trust any Certification Authority by providing the environmental variable NEXTCLOUD_TRUSTED_CACERTS_DIR to the docker run command of the mastercontainer (but before the last line nextcloud/all-in-one:latest! If it was started already, you will need to stop the mastercontainer, remove it (no data will be lost) and recreate it using the docker run command that you initially used). The value of the variables should be set to the absolute paths of the directory on the host, which contains one or more Certification Authorities certificates. You should use X.509 certificates, Base64 encoded. (Other formats may work but have not been tested!) All the certificates in the directory will be trusted.

When using docker run, the environmental variable can be set with --env NEXTCLOUD_TRUSTED_CACERTS_DIR=/path/to/my/cacerts.

In order for the value to be valid, the path should start with / and not end with / and point to an existing directory. Pointing the variable directly to a certificate file will not work and may also break things.

How to disable Collabora's Seccomp feature?

The Collabora container enables Seccomp by default, which is a security feature of the Linux kernel. On systems without this kernel feature enabled, you need to provide --env COLLABORA_SECCOMP_DISABLED=true to the initial docker run command in order to make it work.

How to enable automatic updates without creating a backup beforehand?

If you have an external backup solution, you might want to enable automatic updates without creating a backup first. However note that doing this is disrecommended since you will not be able to easily create and restore a backup from the AIO interface anymore and you need to make sure to shut down all the containers properly before creating the backup, e.g. by stopping them from the AIO interface first.

But anyhow, is here a guide that helps you automate the whole procedure:

Click here to expand

#!/bin/bash

# Stop the containers
docker exec --env STOP_CONTAINERS=1 nextcloud-aio-mastercontainer /daily-backup.sh

# Below is optional if you run AIO in a VM which will shut down the VM afterwards
# poweroff

You can simply copy and paste the script into a file e.g. named shutdown-script.sh e.g. here: /root/shutdown-script.sh.

Afterwards apply the correct permissions with sudo chown root:root /root/shutdown-script.sh and sudo chmod 700 /root/shutdown-script.sh. Then you can create a cronjob that runs it on a schedule e.g. runs the script at 04:00 each day like this:

1. Open the cronjob with sudo crontab -u root -e (and choose your editor of choice if not already done. I'd recommend nano).
2. Add the following new line to the crontab if not already present: 0 4 * * * /root/shutdown-script.sh which will run the script at 04:00 each day.
3. save and close the crontab (when using nano the shortcuts for this are Ctrl + o and then Enter to save, and close the editor with Ctrl + x).

After that is in place, you should schedule a backup from your backup solution that creates a backup after AIO is shut down properly. Hint: If your backup runs on the same host, make sure to at least back up all docker volumes and additionally Nextcloud's datadir if it is not stored in a docker volume.

Afterwards, you can create a second script that automatically updates the containers:

Click here to expand

#!/bin/bash

# Run container update once
if ! docker exec --env AUTOMATIC_UPDATES=1 nextcloud-aio-mastercontainer /daily-backup.sh; then
    while docker ps --format "{{.Names}}" | grep -q "^nextcloud-aio-watchtower$"; do
        echo "Waiting for watchtower to stop"
        sleep 30
    done

    while ! docker ps --format "{{.Names}}" | grep -q "^nextcloud-aio-mastercontainer$"; do
        echo "Waiting for Mastercontainer to start"
        sleep 30
    done

    # Run container update another time to make sure that all containers are updated correctly.
    docker exec --env AUTOMATIC_UPDATES=1 nextcloud-aio-mastercontainer /daily-backup.sh
fi

You can simply copy and paste the script into a file e.g. named automatic-updates.sh e.g. here: /root/automatic-updates.sh.

Afterwards apply the correct permissions with sudo chown root:root /root/automatic-updates.sh and sudo chmod 700 /root/automatic-updates.sh. Then you can create a cronjob that runs e.g. at 05:00 each day like this:

1. Open the cronjob with sudo crontab -u root -e (and choose your editor of choice if not already done. I'd recommend nano).
2. Add the following new line to the crontab if not already present: 0 5 * * * /root/automatic-updates.sh which will run the script at 05:00 each day.
3. save and close the crontab (when using nano the shortcuts for this are Ctrl + o then Enter to save, and close the editor with Ctrl + x).

all-in-one's Issues

400 behind Traefik proxy

When hosting this behind an existing Traefik reverse proxy with HTTPS redirect, the following error occurs when using 8080 as the load balancer port:

Bad Request

Your browser sent a request that this server could not understand.
Reason: You're speaking plain HTTP to an SSL-enabled server port.
Instead use the HTTPS scheme to access this URL, please.

Apache/2.4.51 (Debian) Server at 172.18.0.15 Port 8080

If I change the load balancer port to 8443, I get the following error:

Client sent an HTTP request to an HTTPS server.

If I change it to 80, I get an infinitely loading page.

The following is a snippet from my docker-compose.yml:

  # Nextcloud
  nextcloud:
    container_name: nextcloud
    image: nextcloud/all-in-one:latest
    restart: unless-stopped
    networks:
      - proxy
    environment:
      - PUID=${USER_ID}
      - PGID=${GROUP_ID}
      - TZ=${TIMEZONE}
    volumes:
      - /mnt/BigBox/docker-data/nextcloud:/mnt/docker-aio-config
      - /var/run/docker.sock:/var/run/docker.sock:ro
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.nextcloud.entrypoints=https"
      - "traefik.http.services.nextcloud-web.loadbalancer.server.port=8080"
      # Middlewares:
      - "traefik.http.middlewares.nextcloud-redirect-tls.redirectscheme.scheme=https"
      - "traefik.http.middlewares.nextcloud-redirect-tls.redirectscheme.permanent=true"
      # HTTP:
      - "traefik.http.routers.nextcloud-web.rule=Host(`drive.example.com`)"
      - "traefik.http.routers.nextcloud-web.middlewares=nextcloud-redirect-tls"
      - "traefik.http.routers.nextcloud-web.entrypoints=http"
      # HTTPS:
      - "traefik.http.routers.nextcloud-web-secure.rule=Host(`drive.example.com`)"
      - "traefik.http.routers.nextcloud-web-secure.tls=true"
      - "traefik.http.routers.nextcloud-web-secure.entrypoints=https"
    depends_on:
      - traefik

I believe the issue is because all traffic is going over https between Traefik and Nextcloud, and I'm not aware of a way to turn it off without first going through the wizard. Unfortunately, I cannot get to the wizard until I'm past this issue.

If this is indeed the case, it might be useful to have an environment variable to disable HTTPS, or a combination of them to specify that you're using a reverse proxy.

Setting upload max size

I really would like to use the nextcloud all-in-one image since I do not need a lot of control or special requirements regarding my nextcloud instance.
However, I do need to be able to change the maximum upload size. Since I couldn't find any information on this:
Is there a way to manually set the maximum upload size using the all-in-one container?

Feature: Multi Tenant Support

Multi Tenant Support would be a huge plus.

For example we could have several instances of nextcloud on one server

cloud.somedomain.com
cloud.anotherdomain.com
etc

Allow these domains to be added to the AIO WebUI

publish AMI to AWS Marketplace

https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html
https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html
https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html

Disallow creation of local external storage

nextcloud/server#30111
Also add documentation to the readme that this is the case then

Todo:
Discuss with lukas beforehand if we should add an option to mount the /media and/or /mnt directory into the nextcloud container (Would probably then not necessarily run on otherplatforms like macos) #76

Set up Dependabot

driver failed programming external connectivity on endpoint nextcloud-aio-domaincheck

Anyone else seeing this issue?

I just created a brand new Ubuntu 20 Server (VM running in ESXI, NAT'd to a static public IP.), installed Docker. When walking through the install instructions, port forwarding 443, 8443, and 80, installing the NextCloud container; when I log in via the LOCAL IP at 8080 over https with the admin credentials I get The server is not reachable on Port 443.

If I follow the public doc instructions

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

I don't think these instructions are accurate. I can see the public port open on my public IP but visiting the public domain name via 8443 just times out.

add option to mount /mnt and /media and /var/backups into the nextcloud container for the usage of the external storage app

cc @LukasReschke for discussion if we should add this option

It could get enable with an environmental variable.

We could allow passing the exact path via environmental variable (then also other directories than /mnt and /media would be possible)

After restore write file to nextcloud data volume so that it skips any update procedure

Skip from here to here:

all-in-one/Containers/nextcloud/entrypoint.sh

Lines 43 to 206 in 13360b1

	if version_greater "$image_version" "$installed_version"; then
	# Check if it skips a major version
	INSTALLED_MAJOR="${installed_version%%.*}"
	IMAGE_MAJOR="${image_version%%.*}"
	if [ "$installed_version" != "0.0.0.0" ] && [ "$((IMAGE_MAJOR - INSTALLED_MAJOR))" -gt 1 ]; then
	set -ex
	NEXT_MAJOR="$((INSTALLED_MAJOR + 1))"
	curl -fsSL -o nextcloud.tar.bz2 "https://download.nextcloud.com/server/releases/latest-${NEXT_MAJOR}.tar.bz2"
	curl -fsSL -o nextcloud.tar.bz2.asc "https://download.nextcloud.com/server/releases/latest-${NEXT_MAJOR}.tar.bz2.asc"
	export GNUPGHOME="$(mktemp -d)"
	# gpg key from https://nextcloud.com/nextcloud.asc
	gpg --batch --keyserver keyserver.ubuntu.com --recv-keys 28806A878AE423A28372792ED75899B9A724937A
	gpg --batch --verify nextcloud.tar.bz2.asc nextcloud.tar.bz2
	mkdir -p /usr/src/tmp
	tar -xjf nextcloud.tar.bz2 -C /usr/src/tmp/
	gpgconf --kill all
	rm nextcloud.tar.bz2.asc nextcloud.tar.bz2
	rm -rf "$GNUPGHOME" /usr/src/tmp/nextcloud/updater
	mkdir -p /usr/src/tmp/nextcloud/data
	mkdir -p /usr/src/tmp/nextcloud/custom_apps
	chmod +x /usr/src/tmp/nextcloud/occ
	cp /usr/src/nextcloud/config/* /usr/src/tmp/nextcloud/config/
	mv /usr/src/nextcloud /usr/src/temp-nextcloud
	mv /usr/src/tmp/nextcloud /usr/src/nextcloud
	rm -r /usr/src/tmp
	rm -r /usr/src/temp-nextcloud
	# shellcheck disable=SC2016
	image_version="$(php -r 'require "/usr/src/nextcloud/version.php"; echo implode(".", $OC_Version);')"
	IMAGE_MAJOR="${image_version%%.*}"
	set +ex
	fi
	if [ "$installed_version" != "0.0.0.0" ]; then
	while true; do
	echo -e "Checking connection to appstore"
	CURL_STATUS="$(curl -LI "https://apps.nextcloud.com/" -o /dev/null -w '%{http_code}\n' -s)"
	if [[ "$CURL_STATUS" = "200" ]]
	then
	echo "Appstore is reachable"
	break
	else
	echo "Curl didn't produce a 200 status, is appstore reachable?"
	fi
	done
	php /var/www/html/occ maintenance:mode --off
	echo "Getting and backing up the status of apps for later, this might take a while..."
	php /var/www/html/occ app:list | sed -n "/Enabled:/,/Disabled:/p" > /tmp/list_before
	if [ "$((IMAGE_MAJOR - INSTALLED_MAJOR))" -eq 1 ]; then
	php /var/www/html/occ config:system:delete app_install_overwrite
	fi
	php /var/www/html/occ app:update --all
	fi
	echo "Initializing nextcloud $image_version ..."
	rsync -rlD --delete --exclude-from=/upgrade.exclude /usr/src/nextcloud/ /var/www/html/
	for dir in config data custom_apps themes; do
	if [ ! -d "/var/www/html/$dir" ] || directory_empty "/var/www/html/$dir"; then
	rsync -rlD --include "/$dir/" --exclude '/*' /usr/src/nextcloud/ /var/www/html/
	fi
	done
	rsync -rlD --include '/version.php' --exclude '/*' /usr/src/nextcloud/ /var/www/html/
	echo "Initializing finished"
	#install
	if [ "$installed_version" = "0.0.0.0" ]; then
	echo "New nextcloud instance"
	INSTALL_OPTIONS=(-n --admin-user "$ADMIN_USER" --admin-pass "$ADMIN_PASSWORD")
	if [ -n "${NEXTCLOUD_DATA_DIR}" ]; then
	INSTALL_OPTIONS+=(--data-dir "$NEXTCLOUD_DATA_DIR")
	fi
	echo "Installing with PostgreSQL database"
	INSTALL_OPTIONS+=(--database pgsql --database-name "$POSTGRES_DB" --database-user "$POSTGRES_USER" --database-pass "$POSTGRES_PASSWORD" --database-host "$POSTGRES_HOST")
	echo "starting nextcloud installation"
	max_retries=10
	try=0
	until php /var/www/html/occ maintenance:install "${INSTALL_OPTIONS[@]}" || [ "$try" -gt "$max_retries" ]
	do
	echo "retrying install..."
	try=$((try+1))
	sleep 10s
	done
	if [ "$try" -gt "$max_retries" ]; then
	echo "installing of nextcloud failed!"
	exit 1
	fi
	# unset admin password
	unset ADMIN_PASSWORD
	# Apply log settings
	echo "Applying default settings..."
	mkdir -p /var/www/html/data
	php /var/www/html/occ config:system:set loglevel --value=2
	php /var/www/html/occ config:system:set log_type --value=file
	php /var/www/html/occ config:system:set logfile --value="/var/log/nextcloud/nextcloud.log"
	php /var/www/html/occ config:system:set log_rotate_size --value="10485760"
	php /var/www/html/occ app:enable admin_audit
	php /var/www/html/occ config:app:set admin_audit logfile --value="/var/log/nextcloud/audit.log"
	php /var/www/html/occ config:system:set log.condition apps 0 --value="admin_audit"
	# Apply preview settings
	echo "Applying preview settings..."
	php /var/www/html/occ config:system:set preview_max_x --value="2048"
	php /var/www/html/occ config:system:set preview_max_y --value="2048"
	php /var/www/html/occ config:system:set jpeg_quality --value="60"
	php /var/www/html/occ config:app:set preview jpeg_quality --value="60"
	php /var/www/html/occ config:system:delete enabledPreviewProviders
	php /var/www/html/occ config:system:set enabledPreviewProviders 1 --value="OC\\Preview\\Image"
	php /var/www/html/occ config:system:set enabledPreviewProviders 2 --value="OC\\Preview\\MarkDown"
	php /var/www/html/occ config:system:set enabledPreviewProviders 3 --value="OC\\Preview\\MP3"
	php /var/www/html/occ config:system:set enabledPreviewProviders 4 --value="OC\\Preview\\TXT"
	php /var/www/html/occ config:system:set enabledPreviewProviders 5 --value="OC\\Preview\\OpenDocument"
	php /var/www/html/occ config:system:set enabledPreviewProviders 6 --value="OC\\Preview\\Movie"
	php /var/www/html/occ config:system:set enable_previews --value=true --type=boolean
	# Apply other settings
	echo "Applying other settings..."
	php /var/www/html/occ config:system:set upgrade.disable-web --type=bool --value=true
	php /var/www/html/occ config:app:set updatenotification notify_groups --value="[]"
	php /var/www/html/occ config:system:set mail_smtpmode --value="smtp"
	php /var/www/html/occ config:system:set trashbin_retention_obligation --value="auto, 30"
	php /var/www/html/occ config:system:set versions_retention_obligation --value="auto, 30"
	php /var/www/html/occ config:system:set activity_expire_days --value="30"
	php /var/www/html/occ config:system:set simpleSignUpLink.shown --type=bool --value=false
	php /var/www/html/occ config:system:set share_folder --value="/Shared"
	#upgrade
	else
	while [ -n "$(pgrep -f cron.php)" ]
	do
	echo "Waiting for Nextclouds cronjob to finish..."
	sleep 5
	done
	echo "Upgrading nextcloud from $installed_version to $image_version..."
	if ! php /var/www/html/occ upgrade || ! php /var/www/html/occ -V; then
	echo "Upgrade failed. Please restore from backup."
	exit 1
	fi
	php /var/www/html/occ app:list | sed -n "/Enabled:/,/Disabled:/p" > /tmp/list_after
	echo "The following apps have been disabled:"
	diff /tmp/list_before /tmp/list_after | grep '<' | cut -d- -f2 | cut -d: -f1
	rm -f /tmp/list_before /tmp/list_after
	# Apply optimization
	echo "Doing some optimizations..."
	php /var/www/html/occ maintenance:repair
	php /var/www/html/occ db:add-missing-indices
	php /var/www/html/occ db:add-missing-columns
	php /var/www/html/occ db:add-missing-primary-keys
	yes | php /var/www/html/occ db:convert-filecache-bigint
	php /var/www/html/occ maintenance:mimetype:update-js
	php /var/www/html/occ maintenance:mimetype:update-db
	fi
	fi

and remove the file at the very end of the entrypoint script.

Also skip the database update in this case not possible

Move/Import from existing Nextcloud

Hey there,

we do have an existing nextcloud instance. It could be interesting for us to switch to AIO, since we would then profit from the talk high performance backend.

I now wonder, how we would move our existing data (files/calendars/deck/talk and more) and also our https://apps.nextcloud.com/apps/user_sql implementation. Is there something specific? Can you lead the way and maybe also add a few lines to your documentation?

Best

Only use the talk docker image

Hi,
would it be possible to use only the talk HPB docker?
And setup the nextcloud, collabora myself?
Thanks a lot!

Hardening login process

The login process for the management container is currently set to six random words. There are several things that can be done to make the login more secure.

Action Items

• #4
• Don't allow login via the management container login if Apache is running (and not starting or stopped)
  • Login will happen via button inside Nextcloud (SSO)
• Add command line tool to unlock the management container login
  • In case users the Nextcloud container isn't running properly

Built-in Mail Server

An Optional Built in mail server would be very useful.

When a Nextcloud user gets created it can also create the mail user and same with deletion.
This would run in a separate docker container.

Ways to adujst: data-directory / logging / https required

Hi there,

just some questions to check, if nextcloud aio can be adjusted to my scenario.
First of all, thank you so much for this initiative. This really helps normal users to set up an optimized nextcloud environment.
It in general includes exactly what I was looking for.
Some adjustments would have to be done by me to be able to run it in my environment.
Are there switches for that already or planned for the future?

1. Nextcloud data directory
   Nextcloud aio is to run on a SSD whereas the data is to be stored on a large HDD. Therefore I would have to adjust the data directory for the nextcloud container (residing outside of the container).
   Is there a way to change the directory yet? Manual interaction with the container would be lost after an upgrade using the master container, I assume.
2. Keep http instead of https for internal networks (reverse proxy)
   I use a reverse proxy. Concerning this topic there seems to be sth going on already. But for testing I didn´t want to allow access from the internet. So the server is not accessible for the certificate generation. In that case the setup using aio will fail. Is there any way around that at the moment?
3. Adjust logging for fail2ban setup
   Using the reverse proxy to control access to the network the reverse proxy hosts the fail2ban instance.
   Therefore I would have to delegate the nextcloud log to the reverse proxy (rsyslog).
   Is there a way to accomplish this setup already?

Thanks for your help and once again thanks for your work!!

Greetings,
Christian

Add Kubernetes Support

It would be nice to run the all-in-one image on Kubernetes. There's https://github.com/nextcloud/helm for previous versions available and it would be great to see a tighter coupling between this image and the Kubernetes' helm charts.

Exclude the session folder from restore

The cert folder as well

domain does not point to this server

Containers are all coming up ok, admin login works fine. When I get to the "Please type in the domain that will be used for Nextcloud:" portion, I input my domain name and get the error "domain does not point to this server". I'm able to ping the domain and in fact have pulled up the admin login using my domain, but I still get the error message.

Debian 10.11 w/current docker install based off of AIO instructions. NGINX proxy manager is forwarding cloud.xxxx.xyz using https to 192.168.1.82:8080.

Ideas?

documentation - docker from get.docker.com vs. distribution package source

In README.md i found that the user can (must) install Docker from get.docker.com .
Is this ever the correct way?

If not perhaps the documentation can be optimized for beginners, experts, ....

Improve documentation

I think adding a bit of documentation or some sort of FAQ to the Readme would be very helpful for both users and people who are wondering if this fits their use case. This is particular so because the target audience for this (if I understood correctly) is people with less knowledge than your typical system administrator.

Things that I'd like to see:

• How to update to a new version of nextcloud?
• Is it possible to run occ?
• If not, how do you restore from backup? (is it even possible? Maybe related to #39)

Maybe others have more suggestions

Add option to enable auto backups each day - let type in a CT time for now

• block login for 5min or so before the backup starts and delete all sessions

• update mastercontainer first: create a file that the update was run. if the file exists, continue directly with updating the and backing up the rest...

• only show the option after the initial backup was created

• Also make clear that this automatically start the containers after the backup is done which will automatically update them (except the mastercontainer)

• Needs to remove all sessions when the job starts in the background so that you don't get into any race conditions (and also set auth state to logged out?)

• hide start containers button when auto backup is running (starting all containers directly after borgbackup container should prevent that (maybe delete the sessions again after the backup container was started to make sure))

• #39

• #67

• https://unix.stackexchange.com/a/94521

• inform about the state of the backup (wait until the nextcloud container is running again qfter backup xontainer was started and all other containers were started) and then send the notification

• may also update all nextcloud apps on startup (not if backup was restored)

if backup creation fails, add file to nextcloud container so that it skips any automatic update

and remove it always if the backup was successful. (rm -f)

Clarify backup systems

Nextcloud now has a backup system (https://github.com/nextcloud/backup) I wonder how this relates to the Borg implementation in AIO?

I think it would be wise to have one solution for backups and make that work well across all implementations of nextcloud. This would also make migrations easier and more reliable.

show failed backup also if the initial backup failed

currently when the backup fails during the initial create backup you cant see the log files. Make it posssible to do so.

Increase length of password to 8 words

Disable HTTP challenge for aio-apache

aio-apache should only use the ALPN challenge. This can likely be achieved by a configuration change in the in the Caddyfile as documented at https://caddyserver.com/docs/caddyfile/directives/tls#acme with disable_http_challenge

all-in-one/Containers/apache/Caddyfile

Lines 1 to 7 in 9ee27cb

	{
	auto_https disable_redirects
	storage file_system {
	root /mnt/data/caddy
	}
	}

So add https:// to this line

all-in-one/Containers/apache/Caddyfile

Line 9 in 3a67636

{$NC_DOMAIN}:443 {

Permission denied (13) in /var/www/docker-aio/php/public/index.php on line 43

Hi all,

I'm getting the error below when starting the container using the provided instructions.
Any ideas?

Thanks in advance,

Tim

Warning: session_start(): open(/mnt/docker-aio-config/session//sess_de4bea132c31c531df8bfa926227e620, O_RDWR) failed: Permission denied (13) in /var/www/docker-aio/php/public/index.php on line 43

Warning: session_start(): Failed to read session data: files (path: /mnt/docker-aio-config/session/) in /var/www/docker-aio/php/public/index.php on line 43

Fatal error: Uncaught RuntimeException: Invalid CSRF storage. Use session_start() before instantiating the Guard middleware or provide array storage. in /var/www/docker-aio/php/vendor/slim/csrf/src/Guard.php:139 Stack trace: #0 /var/www/docker-aio/php/vendor/slim/csrf/src/Guard.php(113): Slim\Csrf\Guard->setStorage(NULL) #1 /var/www/docker-aio/php/public/index.php(37): Slim\Csrf\Guard->__construct(Object(Http\Factory\Guzzle\ResponseFactory)) #2 [internal function]: {closure}() #3 /var/www/docker-aio/php/vendor/php-di/invoker/src/Invoker.php(74): call_user_func_array(Object(Closure), Array) #4 /var/www/docker-aio/php/vendor/php-di/php-di/src/Definition/Resolver/FactoryResolver.php(80): Invoker\Invoker->call(Object(Closure), Array) #5 /var/www/docker-aio/php/vendor/php-di/php-di/src/Definition/Resolver/ResolverDispatcher.php(71): DI\Definition\Resolver\FactoryResolver->resolve(Object(DI\Definition\FactoryDefinition), Array) #6 /var/www/docker-aio/php/vendor/php-di/php-di/src/Container.php(387): DI\Definition\Resolver\ResolverDispatcher->resolve(Object(DI\Definition\FactoryDefinition), Array) #7 /var/www/docker-aio/php/vendor/php-di/php-di/src/Container.php(138): DI\Container->resolveDefinition(Object(DI\Definition\FactoryDefinition)) #8 /var/www/docker-aio/php/public/index.php(49): DI\Container->get('Slim\\Csrf\\Guard') #9 {main} thrown in /var/www/docker-aio/php/vendor/slim/csrf/src/Guard.php on line 139

publish new images after recent PRs are merged and tested

successfully tested:

• #58 (see if it successfully builds)
• #59
• #60 works with #92
• #61
• #62
• #63
• #64
• #77 (see if it successfully builds)
• #89
• #91 (see if it successfully builds)

When done, publish affected images to latest

• nextcloud
• apache
• borgbackup
• all-in-one
• postgresql
• redis

publish VM to Google Cloud Marketplace

https://cloud.google.com/marketplace/docs/partners/get-started

Doesn't work with port mapping (Apache)

Running with

docker run -it --name nextcloud-aio-mastercontainer --restart always -p 97:80 -p 8097:8080 -p 8460:8443 -p 460:443 -p 3495:3478 --volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config --volume /var/run/docker.sock:/var/run/docker.sock:ro nextcloud/all-in-one:latest

and configuring the local reverse proxy accordingly, I end up with an Internal error (specific information not available) when I try to access the server.

Has anyone gotten this working with Apache port mapping?

Remove username

cc @LukasReschke if we need a username since we don't want to support multiusers and the password is authentication enough, no?

Add support for ARM64

• #147
• #148
• Build containers for multiple architectures: done with nextcloud-releases/all-in-one#3
• fix containers for arm64 (at least in those places, maybe more: https://github.com/nextcloud/all-in-one/search?q=amd64 and https://github.com/nextcloud-releases/all-in-one/runs/4860610776?check_suite_focus=true) fixed with #153
• fix notify push #162
• set up an arm64 testing machine
• test that everything works
• publish to latest
• add docs

make database export failproof

• add a skip-file before the export, remove it after it is successful
• if the file is present, skip any update of the database and just exit the database container -> report to github
• also cancel a backup creation if that file is present

Fails to start when port 443 in use.

Container nextcloud-aio-domaincheck fails to start if port 443 is already in use on the host.
Any way to map this to another port?

publish to marketplaces

• Google Cloud
• https://cloud.google.com/build/docs/building/build-vm-images-with-packer
• https://github.com/GoogleCloudPlatform/cloud-builders-community/tree/master/packer/examples/gce
• https://cloud.google.com/marketplace/docs/partners/get-started
• https://cloud.google.com/marketplace/docs/partners/vm

---

• AWS
• https://docs.aws.amazon.com/cli/latest/userguide/cli-services-ec2-instances.html#launching-instances
• https://www.ipswitch.com/blog/import-machine-images-into-aws-with-packer
• https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html
• https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html
• https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/creating-an-ami-ebs.html
• https://learn.hashicorp.com/collections/packer/aws-get-started

---

• Digitalocean
• https://docs.digitalocean.com/products/images/custom-images/how-to/upload/
• https://marketplace.digitalocean.com/vendors
• https://github.com/digitalocean/marketplace-partners#digitalocean-marketplace-partner-tools

---

• Microsoft Azure
• https://docs.microsoft.com/en-us/azure/marketplace/marketplace-virtual-machines
• https://docs.microsoft.com/en-us/azure/virtual-machines/linux/tutorial-manage-vm
• https://docs.microsoft.com/en-us/azure/marketplace/azure-vm-use-approved-base
• https://github.com/Azure/azvmimagebuilder/tree/main/quickquickstarts/0_Creating_a_Custom_Linux_Managed_Image

---

• IONOS didn't find docs about how to do that.

---

• Linode
• https://www.linode.com/marketplace/app-partners/
• https://www.linode.com/docs/guides/how-to-deploy-a-new-linode-using-a-stackscript/

---

• OVH

fulltextsearch support

Should be added to the optional section

Allow to run this behind a reverse proxy

Adjust the php config to sane defaults

I would love to have the possibility to adjust the PHP settings, because I’m often hitting the 5 PHP-FPM processes limit.

WARNING: [pool www] server reached pm.max_children setting (5), consider raising it

I would suggest to add a config page to the AIO console, but doing it trough docker vars could work too.

The configuration of the mastercontainer is not stored in the volume

I was testing the backups and my backup-container exited with configuration.json not present. Cannot perform the backup!

After some investigation I noticed that the configuration.json of the mastercontainer is no longer saved to /mnt/docker-aio-config/data/configuration.json

root@ubuntu-2gb-fsn1-2:~/all-in-one# docker exec -it nextcloud-aio-mastercontainer ls -la /mnt/docker-aio-config/data/
total 8
drwxrwx--- 2 www-data www-data 4096 Dec  3 12:20 .
drwxrwx--- 6 root     root     4096 Dec  3 12:20 ..

I tested with the nextcloud/all-in-one:develop image.

Update buster images to bullseye

Domain does not point to this server.

Hi,
not sure what is wrong here, Nextcloud Docker (nextcloud-aio-domaincheck) is reachable via Port 443 and showing a ID or something
Yet the AIO Tools says "Domain does not point to this server." Any Hits what the Problem?

Access Nextcloud AIO on Port 8443 dont work

I installed the nextcloud aio container. I get on port 8080 but not on port 8443 how do I tell the docker which host name it should listen to?

Remove the updatenotification app

It shows nextcloud updates which are not applicable here.

solution: Just remove the app to get rid of possible confusion.

also remove at least this

all-in-one/Containers/nextcloud/entrypoint.sh

Line 169 in 13360b1

php /var/www/html/occ config:app:set updatenotification notify_groups --value="[]"

and maybe this too

all-in-one/Containers/nextcloud/entrypoint.sh

Line 168 in 13360b1

php /var/www/html/occ config:system:set upgrade.disable-web --type=bool --value=true

run docker image prune regularly

probably add docker-cli into the mastercontainer and specify the socket. Then we should be able to put sudo -u www-data docker image prune -f and sudo -u www-data docker volume prune -f into the cronfile so that it runs once a day.

all-in-one/Containers/mastercontainer/cron.sh

Lines 4 to 7 in 13360b1

	while true; do
	php /var/www/docker-aio/php/src/Cron/cron.php
	sleep 1d
	done

https://stackoverflow.com/a/65588785
also add chmod +x

Fatal Error: driver failed programming external connectivity

I am using port 80 and 443 already for apache.

after this startup command:

sudo docker run -it --name nextcloud-aio-mastercontainer --restart always -p 8082:80 -p 8080:8080 -p 8443:8443 --volume /Docker/Nextcloud_Beta/Container-Data/nextcloud_aio_mastercontainer:/mnt/docker-aio-config --volume /var/run/docker.sock:/var/run/docker.sock:ro nextcloud/all-in-one:develop

I get this error message in my browser after logging in on port 8080

Fatal error: Uncaught GuzzleHttp\Exception\ServerException: Server error: `POST http://localhost/v1.41/containers/nextcloud-aio-domaincheck/start` resulted in a `500 Internal Server Error` response: {"message":"driver failed programming external connectivity on endpoint nextcloud-aio-domaincheck (24c0d047eafd1a5bb1896 (truncated...) in /var/www/docker-aio/php/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php:113 Stack trace: #0 /var/www/docker-aio/php/vendor/guzzlehttp/guzzle/src/Middleware.php(69): GuzzleHttp\Exception\RequestException::create(Object(GuzzleHttp\Psr7\Request), Object(GuzzleHttp\Psr7\Response), NULL, Array, NULL) #1 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/Promise.php(204): GuzzleHttp\Middleware::GuzzleHttp\{closure}(Object(GuzzleHttp\Psr7\Response)) #2 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/Promise.php(153): GuzzleHttp\Promise\Promise::callHandler(1, Object(GuzzleHttp\Psr7\Response), NULL) #3 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/TaskQueue.php(48): GuzzleHttp\Promise\Promise::GuzzleHttp\Promise\{closure}() #4 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/Promise.php(248): GuzzleHttp\Promise\TaskQueue->run(true) #5 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/Promise.php(224): GuzzleHttp\Promise\Promise->invokeWaitFn() #6 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/Promise.php(269): GuzzleHttp\Promise\Promise->waitIfPending() #7 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/Promise.php(226): GuzzleHttp\Promise\Promise->invokeWaitList() #8 /var/www/docker-aio/php/vendor/guzzlehttp/promises/src/Promise.php(62): GuzzleHttp\Promise\Promise->waitIfPending() #9 /var/www/docker-aio/php/vendor/guzzlehttp/guzzle/src/Client.php(187): GuzzleHttp\Promise\Promise->wait() #10 /var/www/docker-aio/php/vendor/guzzlehttp/guzzle/src/ClientTrait.php(95): GuzzleHttp\Client->request('POST', 'http://localhos...', Array) #11 /var/www/docker-aio/php/src/Docker/DockerActionManager.php(155): GuzzleHttp\Client->post('http://localhos...') #12 /var/www/docker-aio/php/src/Controller/DockerController.php(40): AIO\Docker\DockerActionManager->StartContainer(Object(AIO\Container\Container)) #13 /var/www/docker-aio/php/src/Controller/DockerController.php(165): AIO\Controller\DockerController->PerformRecursiveContainerStart('nextcloud-aio-d...') #14 /var/www/docker-aio/php/public/index.php(75): AIO\Controller\DockerController->StartDomaincheckContainer() #15 /var/www/docker-aio/php/vendor/slim/slim/Slim/Handlers/Strategies/RequestResponse.php(43): Closure->{closure}(Object(GuzzleHttp\Psr7\ServerRequest), Object(GuzzleHttp\Psr7\Response), Array) #16 /var/www/docker-aio/php/vendor/slim/slim/Slim/Routing/Route.php(384): Slim\Handlers\Strategies\RequestResponse->__invoke(Object(Closure), Object(GuzzleHttp\Psr7\ServerRequest), Object(GuzzleHttp\Psr7\Response), Array) #17 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(81): Slim\Routing\Route->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #18 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(81): Slim\MiddlewareDispatcher->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #19 /var/www/docker-aio/php/vendor/slim/slim/Slim/Routing/Route.php(341): Slim\MiddlewareDispatcher->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #20 /var/www/docker-aio/php/vendor/slim/slim/Slim/Routing/RouteRunner.php(84): Slim\Routing\Route->run(Object(GuzzleHttp\Psr7\ServerRequest)) #21 /var/www/docker-aio/php/vendor/slim/csrf/src/Guard.php(456): Slim\Routing\RouteRunner->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #22 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(209): Slim\Csrf\Guard->process(Object(GuzzleHttp\Psr7\ServerRequest), Object(Slim\Routing\RouteRunner)) #23 /var/www/docker-aio/php/vendor/slim/twig-view/src/TwigMiddleware.php(125): Psr\Http\Server\RequestHandlerInterface@anonymous->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #24 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(147): Slim\Views\TwigMiddleware->process(Object(GuzzleHttp\Psr7\ServerRequest), Object(Psr\Http\Server\RequestHandlerInterface@anonymous)) #25 /var/www/docker-aio/php/src/Middleware/AuthMiddleware.php(38): Psr\Http\Server\RequestHandlerInterface@anonymous->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #26 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(313): AIO\Middleware\AuthMiddleware->__invoke(Object(GuzzleHttp\Psr7\ServerRequest), Object(Psr\Http\Server\RequestHandlerInterface@anonymous)) #27 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(81): Psr\Http\Server\RequestHandlerInterface@anonymous->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #28 /var/www/docker-aio/php/vendor/slim/slim/Slim/App.php(215): Slim\MiddlewareDispatcher->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #29 /var/www/docker-aio/php/vendor/slim/slim/Slim/App.php(199): Slim\App->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #30 /var/www/docker-aio/php/public/index.php(140): Slim\App->run() #31 {main} thrown in /var/www/docker-aio/php/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php on line 113

I guess this is a duplicate of #52 (comment) and #53 (comment) ?

Documentation: Access / editing files via sftp

Noob alert! Since this project is aimed at beginners: Some stuff is different when using Docker than using the standard install. The documents from the NC instance seem to reside in /var/lib/docker/volumes/nextcloud_aio_nextcloud_data/_data but editing them there directly via sftp or ssh does not work. Files I create via ssh don't show up in the NC interface. So: How can I do this (for the rare case I might need to do so)? I have become familiar with docker-compose where directories are mapped but here it is different again.

Don't worry, I'll be learning more about Docker, this is just a general remark for making AIO more accessible for beginners!

Thanks so much for this project, I am testing it right now and consider using it for my main NC instance although it is still beta. Keep up your great work!

Docker socket is not readable by the www-data user.

The container does not start if the docker group does not have the expected group id. This is what I did:

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
Unable to find image 'nextcloud/all-in-one:latest' locally
latest: Pulling from nextcloud/all-in-one
eff15d958d66: Pull complete 
933427dc39f7: Pull complete 
35bb08dc7ee2: Pull complete 
58a3f26800d7: Pull complete 
bba5c0e912ac: Pull complete 
62e5c0d120c5: Pull complete 
410a26230a3b: Pull complete 
cfd99187016c: Pull complete 
c32ab7d5171e: Pull complete 
0d32eb2980c3: Pull complete 
991f816a61cc: Pull complete 
c8667ca62702: Pull complete 
6405e507a13e: Pull complete 
108fd50a39c4: Pull complete 
a4802c6a0ae4: Pull complete 
4f4fb700ef54: Pull complete 
ed2a8c5d896a: Pull complete 
918f8b879784: Pull complete 
ef811a9a19da: Pull complete 
5957cd578fac: Pull complete 
16271f6bc746: Pull complete 
1fad265ca45b: Pull complete 
d3cff4a42d6b: Pull complete 
ed82917488d5: Pull complete 
e306f9b356b0: Pull complete 
71afc1271985: Pull complete 
0ec4a207d9fd: Pull complete 
891138b323b3: Pull complete 
9ba4b052261a: Pull complete 
df2f9d124a4f: Pull complete 
48b90860d7f8: Pull complete 
2ae887bcd224: Pull complete 
2283bd5bb2d5: Pull complete 
Digest: sha256:9a47ed4b666f74027d710490ae1fac5a078275d2516ce8e671046cb2337fb88b
Status: Downloaded newer image for nextcloud/all-in-one:latest
Docker socket is not readable by the www-data user. Cannot continue.

After checking out the source code I found that the docker group id is explicitly specified in the Dockerfile. This id has to match the docker group id of the host system otherwise we can't control the docker from with the container.

I was able to resolve the issue on my system by changing the id of my docker group with: sudo groupmod -g 998 docker but it probably should be fixed in the image.

Crash on first login

If you login without user and password, you get:

Warning: Undefined array key "username" in /var/www/docker-aio/php/src/Data/ConfigurationManager.php on line 22

Fatal error: Uncaught TypeError: AIO\Data\ConfigurationManager::GetUserName(): Return value must be of type string, null returned in /var/www/docker-aio/php/src/Data/ConfigurationManager.php:22 Stack trace: #0 /var/www/docker-aio/php/src/Auth/AuthManager.php(16): AIO\Data\ConfigurationManager->GetUserName() #1 /var/www/docker-aio/php/src/Controller/LoginController.php(23): AIO\Auth\AuthManager->CheckCredentials('', '') #2 /var/www/docker-aio/php/vendor/slim/slim/Slim/Handlers/Strategies/RequestResponse.php(43): AIO\Controller\LoginController->TryLogin(Object(GuzzleHttp\Psr7\ServerRequest), Object(GuzzleHttp\Psr7\Response), Array) #3 /var/www/docker-aio/php/vendor/slim/slim/Slim/Routing/Route.php(384): Slim\Handlers\Strategies\RequestResponse->__invoke(Array, Object(GuzzleHttp\Psr7\ServerRequest), Object(GuzzleHttp\Psr7\Response), Array) #4 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(81): Slim\Routing\Route->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #5 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(81): Slim\MiddlewareDispatcher->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #6 /var/www/docker-aio/php/vendor/slim/slim/Slim/Routing/Route.php(341): Slim\MiddlewareDispatcher->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #7 /var/www/docker-aio/php/vendor/slim/slim/Slim/Routing/RouteRunner.php(84): Slim\Routing\Route->run(Object(GuzzleHttp\Psr7\ServerRequest)) #8 /var/www/docker-aio/php/vendor/slim/csrf/src/Guard.php(456): Slim\Routing\RouteRunner->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #9 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(209): Slim\Csrf\Guard->process(Object(GuzzleHttp\Psr7\ServerRequest), Object(Slim\Routing\RouteRunner)) #10 /var/www/docker-aio/php/vendor/slim/twig-view/src/TwigMiddleware.php(125): Psr\Http\Server\RequestHandlerInterface@anonymous->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #11 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(147): Slim\Views\TwigMiddleware->process(Object(GuzzleHttp\Psr7\ServerRequest), Object(Psr\Http\Server\RequestHandlerInterface@anonymous)) #12 /var/www/docker-aio/php/src/Middleware/AuthMiddleware.php(38): Psr\Http\Server\RequestHandlerInterface@anonymous->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #13 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(313): AIO\Middleware\AuthMiddleware->__invoke(Object(GuzzleHttp\Psr7\ServerRequest), Object(Psr\Http\Server\RequestHandlerInterface@anonymous)) #14 /var/www/docker-aio/php/vendor/slim/slim/Slim/MiddlewareDispatcher.php(81): Psr\Http\Server\RequestHandlerInterface@anonymous->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #15 /var/www/docker-aio/php/vendor/slim/slim/Slim/App.php(215): Slim\MiddlewareDispatcher->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #16 /var/www/docker-aio/php/vendor/slim/slim/Slim/App.php(199): Slim\App->handle(Object(GuzzleHttp\Psr7\ServerRequest)) #17 /var/www/docker-aio/php/public/index.php(140): Slim\App->run() #18 {main} thrown in /var/www/docker-aio/php/src/Data/ConfigurationManager.php on line 22

Allow to select the borg archive to restore from

Currently it is only possible to restore the most recent backup. Make it possible to select an archive.

allow to restore the whole instance from the borg backup in the very first step

On the screen where you enter your domain, you should have the possibility to restore your instance from backup. on the bottom

• Choose directory where the backup lies
• enter the encryption password

When both are entered, test if borg list... works and return the backup archives. If yes show a list with the archives to restore from and a button to restore. If not, show that either bacckup arcchive is not found or the password is incorrect.

• after restore inform that the new aio password will be kept so overwrite the old restored aio password after restore through current new one; must then be copied before the restore process starts
• temporarily rsync the whole volumes directory to a temp place in the backup container
• If the restore fails, rsync the temp directory back so that you can easily start at this point again.
• overwrite the old backup directory through the new one (also copy it before restore) so that you don't need to change it back to the backup directory to the old one after restore and simply can use the new directory for new backups.
• maybe add a additional page on the first setup (after login) that explains what nextcloudaio is (instead of on the credentials screen) and show two options: restore from borg backup (old) nextcloud aio instance backup or to create a new one

Add "Default Phone Region" to config.php

Security & setup warnings displays the "missing default phone region" after initial install

This can, of course, be added by changing the config.php in the specific "nextcloud/aio-nextcloud:latest"-container but maybe this parameter can also be implemented somehow, giving the user the change to adapt this value to match the user's personal needs?