How to install Nextcloud All-in-One (AIO) on Windows 11 with Docker

Nextcloud - Nextcloud Hub 26 Summer:
Nextcloud Hub 26 Summer:
Autonomy for Teams, Office on desktop, a fresh take on Photos

Explore what’s new in the release blog!

Read more

Running your own Nextcloud gives you full control over your files, calendars, chats, and documents, but setting up a server stack by hand can be intimidating. With Nextcloud All-in-One (AIO), you can start a single Docker container and a browser-based interface handles the rest, from domain checks and certificates to optional add-ons, backups, and updates.

In this guide, we walk you through every step of installing Nextcloud AIO on a Windows 11 PC, from installing Docker Desktop to logging in to your new Nextcloud instance and setting up backups. If you’re on Linux, check out our Nextcloud AIO guide for Linux instead.

What is Nextcloud All-in-One?

Nextcloud All-in-One is a Docker-based project that allows you to install just one container that does the heavy lifting of creating and managing all containers needed for a complete Nextcloud installation. It provides easy deployment and maintenance of Nextcloud’s features, a user-friendly interface, stress-free updates, and a straightforward approach for getting everything to work out of the box.

Nextcloud AIO includes:

Nextcloud AIO is free for up to 100 users. If you need more, Nextcloud Enterprise has you covered.

Requirements

Before you start, make sure your setup meets the following requirements:

  • A Windows 11 PC with an x64 CPU, at least 8 GB of RAM, and four cores. Docker Desktop runs your containers in a lightweight virtual machine, so Windows needs more resources than a Linux server for the same setup.
  • Hardware virtualization enabled in your PC’s BIOS/UEFI settings, which Docker Desktop needs to run. See the Docker Desktop system requirements for Windows for details.
  • Suitable storage: An SSD is recommended. HDDs work but are noticeably slower.
  • A domain. You can use a domain you already own, or, if you don’t have one, Nextcloud AIO can register a free deSEC domain for you during setup (see Step 4).
  • The ability to open ports in your firewall or router, so your Nextcloud is reachable from the internet. Make sure that you are not behind CGNAT. If you use the free deSEC domain, you can skip port forwarding for now and do it later, once you want to make your instance publicly accessible. If you can’t open ports at all or don’t want your instance to be reachable from the internet, take a look at the guides for running Nextcloud AIO via Tailscale or running Nextcloud AIO locally.

Please note that this guide is for a setup without a web server or reverse proxy (like Apache, nginx, etc.) already in place. If you want to run Nextcloud AIO behind a web server or reverse proxy, check the corresponding documentation page.

💡 The steps in this guide also work on Windows 10 version 22H2. However, Windows 10 has reached the end of its support, and Docker only supports Windows versions that Microsoft still services, so future Docker Desktop releases might no longer run on it.

Step 1: Install Docker Desktop

On Windows, you run Nextcloud AIO with Docker Desktop, which uses the Windows Subsystem for Linux (WSL 2) in the background.

Download Docker Desktop for Windows and run the installer. When asked about the configuration, keep the option to use WSL 2 enabled.

Configuration of Docker Desktop for Windows screenshot

When the installation has finished, click on “Close and restart” to restart your PC.

Installation succeeded Docker Desktop for Windows screenshot

After the restart, open Docker Desktop and accept the Docker Subscription Service Agreement. You can skip the sign-in and the welcome survey.

Docker Subscription Service Agreement screenshot

⚠️ If Docker Desktop tells you that WSL needs to be updated, open the Command Prompt and run:

wsl --update

Then restart Docker Desktop.

You should now see the Docker Desktop home screen.

Docker home screen screenshot

Since Nextcloud AIO should keep running after you restart your PC, open the Docker Desktop settings and, under General, enable Start Docker Desktop when you log in.

Docker Desktop installation process

If you need IPv6 support, follow the instructions for how to enable IPv6 for Docker.

Step 2: Start the Nextcloud AIO mastercontainer

Nextcloud AIO uses a special container, the mastercontainer, to create and manage all the other containers in your Nextcloud setup.

Open the Command Prompt (search for “cmd” in the Start menu), then start the mastercontainer with this command:

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 ^
--env NEXTCLOUD_DATADIR="/run/desktop/mnt/host/c/ncdata" ^
ghcr.io/nextcloud-releases/all-in-one:latest

⚠️ Use the Command Prompt, not PowerShell. The ^ at the end of each line tells the Command Prompt that the command continues on the next line, and PowerShell doesn’t understand it.

The NEXTCLOUD_DATADIR line tells Nextcloud AIO to store your files in a folder on your Windows drive instead of inside Docker, so you can easily access them from Windows. In this example, /run/desktop/mnt/host/c/ncdata stands for C:\ncdata. To use a different folder, keep the /run/desktop/mnt/host/ part and append the drive letter and path, e.g., /run/desktop/mnt/host/d/nextcloud for D:\nextcloud.

A few things to keep in mind about this command:

  • Choose your data folder now. You can’t change it after the initial installation without extra steps.
  • Use an internal drive (SATA or NVMe) for the data folder. External drives, like USB drives or network drives, don’t work.
  • Don’t change the container name (nextcloud-aio-mastercontainer) or the volume name (nextcloud_aio_mastercontainer). Updates of the mastercontainer and the built-in backups depend on them.
  • If port 8080 is already in use on your PC, you can map the Nextcloud AIO interface to a different host port, e.g., --publish 8081:8080.

Step 3: Open the Nextcloud AIO interface and log in

Once the mastercontainer is running, open the Nextcloud AIO interface in your browser at https://localhost:8080.

⚠️ Always use localhost or an IP address, not a domain, when you access port 8080. Otherwise, HSTS might block access to the interface later.

Port 8080 uses a self-signed certificate, so you need to accept the certificate warning in your browser. Then you should see a screen showing your Nextcloud AIO passphrase.

Screenshot of Nextcloud AIO setup screen

Copy the passphrase and store it somewhere safe, like a password manager. You’ll need it every time you log in to the Nextcloud AIO interface.

Click on “Open Nextcloud AIO login” and paste your passphrase.

Screenshot of Nextcloud AIO login with passphrase screen

You should now see the Nextcloud AIO interface.

Screenshot of Nextcloud AIO new instance screen

⚠️ Once your Nextcloud is up and running, logging in to the Nextcloud AIO interface directly with the passphrase is blocked for security reasons. To get back in, log in to Nextcloud as an admin, go to Administration settings → Overview (https://your-domain.com/settings/admin/overview), and click the button at the top to open the Nextcloud AIO login. You can then log in with your passphrase as usual.

Step 4: Enter your domain

Next, you need to tell Nextcloud AIO which domain to use for your Nextcloud. You can either use your own domain or let Nextcloud AIO register a free one for you.

Option A: Use your own domain

Type in your domain. Nextcloud AIO checks whether the domain points to your PC and whether the required ports are reachable, and the interface helps you figure out what to fix if they aren’t.

For the check to pass, set up the DNS record (or DDNS) for your domain so that it points to your public IP address, and forward the following ports in your router to your Windows PC:

  • 443/TCP for Nextcloud itself (required)
  • 443/UDP if you want to enable HTTP/3 (optional)
  • 3478/TCP and 3478/UDP for the Talk TURN server (only required if you enable Nextcloud Talk)

Option B: Get a free domain from deSEC

If you don’t have a domain yet, or you just want to try out Nextcloud AIO, you can get a free domain right from the Nextcloud AIO interface. Nextcloud AIO uses deSEC, a Berlin-based, non-profit DNS hosting service, to register a subdomain under dedyn.io and handle the technical setup for you: it creates the DNS records, makes sure the domain points to your PC, and requests the SSL certificate. Since the certificate is obtained via the DNS challenge, you don’t need to forward any ports until you want to make your instance publicly accessible.

On the start screen, expand the section “Don’t have a domain? Get a free one from deSEC”.

Start screen of a new Nextcloud AIO instance with the option to register a free domain

Create a new deSEC account with your email address, or enter your credentials if you already have one. Optionally, choose the subdomain you’d like (the part before .dedyn.io). If you leave it blank, Nextcloud AIO picks a random one.

Then click Register free domain via deSEC.

As soon as your deSEC account is activated and the domain is registered, Nextcloud AIO sets it as your Nextcloud domain and keeps its DNS record up to date whenever your public IP address changes. It also sets up the Caddy community container as a reverse proxy and the dnsmasq container, which lets devices on your local network reach Nextcloud via the domain. For that last part, you need to make one change in your router; see the dnsmasq documentation for details.

Nextcloud AIO then downloads and starts the required containers automatically.

Step 5: Choose your add-ons and start the containers

Once your domain passes the check, you can continue to the next screen. Here, you can choose the optional add-ons you want and set your time zone. Then click on “Start containers” to download and start them.

Screenshot of Nextcloud AIO download and start containers screen

You should now see a spinner while Nextcloud AIO downloads the containers. Depending on your internet speed, this usually takes around 10 minutes or more.

Screenshot of Nextcloud AIO loading containers screen

When all containers are downloaded, you will see this screen showing the containers still starting. During this time, Nextcloud AIO runs the initial Nextcloud installation for you.

Screenshot of Nextcloud AIO containers and optional containers screen

Step 6: Log in to your new Nextcloud

When everything is done, the admin credentials will be displayed.

Screenshot of Nextcloud AIO containers and backup and restore screen

You can now open your new Nextcloud instance and log in with the credentials. That’s it! Your Nextcloud is up and running.

Step 7: Set up backups and updates

Before you start moving your data into Nextcloud, take a few minutes to set up backups. Nextcloud AIO comes with a built-in backup solution based on BorgBackup. Backups are incremental, compressed, and encrypted, so only the first one takes a while.

Create your first backup

On Windows, the easiest way to store backups on one of your drives is a Docker volume that points to a folder on that drive. Ideally, use a different drive than the one your Nextcloud data is on. To create the volume, run the following command in the Command Prompt:

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, the backups are stored in E:\your\backup\path. To use a different folder, adjust /host_mnt/e/your/backup/path accordingly. Note that this path starts with /host_mnt/, not /run/desktop/mnt/host/ like the data folder in Step 2.

Then:

  1. Open the Nextcloud AIO interface and go to the backup section.
  2. Enter nextcloud_aio_backupdir as the backup location.
  3. Click on Create backup.

Nextcloud AIO shows you an encryption key for your backups. Store this key in a safe place. Without it, you won’t be able to restore your instance from a backup.

After the first backup is done, you can enable daily backups. With daily backups enabled, you can also turn on automatic updates for all containers, Nextcloud, and its apps.

Note that files you connect to Nextcloud via the external storage app are not included in Nextcloud AIO’s backups.

Keep your instance up to date

When updates are available, Nextcloud AIO notifies all Nextcloud admins, and the Nextcloud AIO interface shows them below the containers section. To install them, create a backup first, then click on Stop containers and Start and update containers.

If you’ve enabled daily backups with automatic updates, Nextcloud AIO does all of this for you.

Troubleshooting

If you run into problems during the installation, these sections of the Nextcloud AIO documentation cover the most common issues:

  • The domain check fails even though everything is configured correctly: You can skip the domain validation.
  • Something went wrong during the initial setup and you want to start over: Here’s how to properly reset the instance. Only do this on a fresh installation, since it deletes all data. On Windows, you might need to remove some volumes manually afterward, e.g., with docker volume rm nextcloud_aio_backupdir and docker volume rm nextcloud_aio_nextcloud_datadir. If you used a data folder on your drive, delete it as well.
  • A command from the Nextcloud AIO documentation doesn’t work: Most commands in the documentation start with sudo docker. Since sudo isn’t available on Windows, simply remove sudo and run the rest of the command.

For everything else, check out the Nextcloud AIO FAQ or ask the community in the Nextcloud forum.

Conclusion

With Nextcloud AIO, a few commands and some clicks in the browser are all it takes to run your own Nextcloud on Windows 11, with backups and updates handled for you.

Once your instance is running, you can easily add even more features, like Fail2ban or Pi-hole. Learn how in our guide to Nextcloud AIO community containers.