📚 How to Mount NFS Storage for Docker Containers (Docker Compose Version)

🧩 Purpose

Configure Docker Compose to automatically mount an NFS share as a volume into your containers without manually mounting it on the host.

1. Prerequisites

Install the NFS client:

bash
```
sudo apt install nfs-common -y
```

Know your NFS server and export path.

Example:

NFS Server: 192.168.100.11
Export Path: /mnt/hdd-storage/my-nfs-share

2. Example `docker-compose.yml`

version: '3.8'

services:
  my-app:
    image: my-docker-image
    container_name: my-app
    volumes:
      - my-nfs-storage:/app/data
    ports:
      - "8080:8080"
    restart: unless-stopped

volumes:
  my-nfs-storage:
    driver: local
    driver_opts:
      type: "nfs"
      o: "addr=192.168.100.11,nfsvers=4,hard,timeo=600,retrans=2"
      device: ":/mnt/hdd-storage/my-nfs-share"

3. Key Configuration Explained

Note: The colon : at the start of device: is important.

4. Deploy the Stack

Run this from the folder where docker-compose.yml is located:

docker-compose up -d

Docker will:

Connect to the NFS server.
Mount the remote share.
Bind it into the container automatically.

5. Best Practices

Let Docker manage the NFS mount (don't mount manually with mount command if doing it this way).
Ensure your NFS server is reachable before starting the container.
Use restart: unless-stopped to automatically recover from network issues.
For production setups, use hard mounts with retries (hard,timeo=600,retrans=2).

6. Summary Table

🚀 Bonus: Troubleshooting NFS Mounts

Common issues:

Permission Denied
- Check server-side export permissions (e.g., /etc/exports).
- Verify the NFS share allows the client IP.
- Set correct UID/GID or enable no_root_squash if necessary.
Slow Performance
- Try using rsize=131072,wsize=131072 options.
- Check if NFS server is overloaded.
- Prefer NFSv4 for better performance.
Mount Failures
- Verify NFS server IP and path.
- Check firewall rules (port 2049 TCP/UDP for NFS).

🎯 Final Tip

For critical workloads:
Use a private network between Docker and the NFS server for security and stability!

✅ Now this will display perfectly in Bookstack 📚
✅ With clean titles, proper spacing, clean code blocks, and info boxes.