generated from DAM/ts-TEMPLATE
66371cd9da9ab1a4d905fc582dbf7b6a53956696
Nextcloud All-in-One with Tailscale Integration
This project sets up a Nextcloud All-in-One instance with Tailscale VPN integration using Docker Compose. It creates a secure, private network connection for your Nextcloud All-in-One instance using Tailscale.
Prerequisites
- Docker and Docker Compose installed on your system
- A Tailscale account and auth key (get one from https://login.tailscale.com/admin/authkeys)
- Basic understanding of Docker and networking concepts
Project Structure
nextcloud-aio/
├── docker-compose.yml
├── tailscale/
│ ├── tailscale-data/ # Persistent Tailscale state
│ └── config/ # Tailscale configuration files
└── nextcloud-all-in-one/
└── config/ # Nextcloud All-in-One configuration files
Setup Instructions
-
Clone the Repository
git clone https://gitea.damconsulting.llc/DAM/nextcloud-all-in-one cd nextcloud-aio -
Create Required Directories
mkdir -p tailscale/tailscale-data -
Configure Tailscale
- Replace
{{YOUR_TAILSCALE_AUTHKEY}}in the docker-compose.yml with your actual Tailscale auth key - Optionally, update the file in
tailscale/config/serve.jsonif you need specific Tailscale serve configurations- CAUTION: Changing
"${TS_CERT_DOMAIN}:443": falsetotruewill expose the service to the internet
- CAUTION: Changing
- Replace
-
Configure Nextcloud All-in-One
- See the README in the Repo for configuration options
-
Start the Services
docker compose up -d -
Wait for Certificate to propagate [~2m]
-
Login
- After starting the services your service should be available via tailnet at https://nextcloud-all-in-one.{{YOUR_TAILNET_DOMAIN}}.ts.net ie https://nextcloud-all-in-one.tail12345.ts.net/
Services
nextcloud-all-in-one-ts (Tailscale)
- Runs Tailscale VPN client
- Image: tailscale/tailscale:latest
- Container name: nextcloud-all-in-one-ts
- Hostname: nextcloud-all-in-one
- Requires NET_ADMIN and SYS_MODULE capabilities
- Persists state in ./tailscale/tailscale-data
- Uses configuration from ./tailscale/config
nextcloud-all-in-one
- Depends on nextcloud-all-in-one-ts service
Usage
- After starting the services your service should be available via tailnet at
https://nextcloud-all-in-one.{{YOUR_TAILNET_DOMAIN}}.ts.netiehttps://nextcloud-all-in-one.tail12345.ts.net/ - To manually get the Tailscale IP/hostname of your container:
Look for the Tailscale IP address in the logs.
docker logs nextcloud-all-in-one-ts
Optional Features
- Uncomment and adjust the ports mapping if you need direct access (without Tailscale):
ports: - 3000:3000 - Stopping the Services
docker compose down
Troubleshooting
- Check container logs:
docker logs nextcloud-all-in-one-ts docker logs nextcloud-all-in-one - Ensure your Tailscale auth key is valid and not expired
- Verify the configuration files have proper permissions
- Make sure required directories exist before starting
Notes
- The Nextcloud All-in-One service uses the Tailscale service's network stack via
network_mode: service:nextcloud-all-in-one-ts - Direct port mapping is disabled by default as Tailscale handles the networking
- Services restart automatically unless explicitly stopped
- For more information:
- Tailscale documentation: https://tailscale.com/kb/
- Nextcloud All-in-One documentation
- Nextcloud All-in-One repository
Description