Skip to main content

📚 Deploying Nextcloud AIO with NFS Storage

📚 Guide Overview

Title: Deploying Nextcloud AIO with NFS Storage

Author: MSLS Partners LLC

Last Updated: May 2025

Description: This guide walks through deploying Nextcloud All-in-One (AIO) using Docker Compose with NFS-mounted storage on Ubuntu Server. It includes all steps from base OS setup to application deployment.

Difficulty Level: Intermediate 🛠️

Estimated Time: 20–30 minutes

📖 Table of Contents

📖 Purpose

To deploy a fully-featured Nextcloud AIO server using Docker Compose, configured to use NFS storage for persistent data.

📖 Requirements

  • Ubuntu Server 22.04 LTS or newer
  • Static IP assigned (e.g., 192.168.100.19)
  • NFS server available at 192.168.100.11
  • Two NFS exports: 
    /mnt/hdd-storage/nfs-nextcloud
/mnt/hdd-storage/nfs-aio-config

📦 Install Docker and Docker Compose

sudo apt update
sudo apt install -y nfs-common ca-certificates curl gnupg lsb-release

# Add Docker GPG key and repo
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo   "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg]   https://download.docker.com/linux/ubuntu   $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Enable and start Docker
sudo systemctl enable docker
sudo systemctl start docker

🔧 Configure NFS Exports on Your NFS Server

Ensure these lines are in your /etc/exports file on the NFS server:

/mnt/hdd-storage/nfs-nextcloud *(rw,no_root_squash,sync,no_subtree_check)
/mnt/hdd-storage/nfs-aio-config *(rw,no_root_squash,sync,no_subtree_check)

Apply the exports:

sudo exportfs -ra

🚀 Deploy Nextcloud AIO with Docker Compose

mkdir -p ~/nextcloud-aio
cd ~/nextcloud-aio
curl -O https://chat.openai.com/mnt/data/nextcloud-aio-with-nfs-volumes.yml
mv nextcloud-aio-with-nfs-volumes.yml docker-compose.yml
docker compose up -d

Once deployed, access the AIO interface via:

http://192.168.100.19:8080

📈 Expected Results

  • Access to AIO web interface
  • Auto-deployment of subcontainers (db, redis, collabora, cron, etc.)
  • Persistent storage on NFS shares

🛠 Troubleshooting

IssueCauseFix
Nextcloud fails to initializeNFS permissions or export missingCheck /etc/exports and re-export
Upload limit too lowPHP or env limitsCheck NEXTCLOUD_UPLOAD_LIMIT in compose file
AIO container won't startDocker permissionsEnsure docker.sock is mounted read-only

📦 Final Notes

  • All environment customization is handled via docker-compose.yml
  • This method is clean, portable, and restart-safe
  • Back up your NFS shares regularly via ZFS snapshot or rsync

Created and maintained by MSLS Partners LLC 📚

Empowering IT with clear documentation and professional best practices.

Version 1.0 | Last Reviewed: May 2025

Back to top