# reinernippes/nextcloud_on_docker architecture

> Architecture diagram of the GitHub repository reinernippes/nextcloud_on_docker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/reinernippes/nextcloud_on_docker
- Repository: https://github.com/reinernippes/nextcloud_on_docker

## Overview

This repository automates deployment of a Docker-based Nextcloud server. An operator configures the inventory and runs the Ansible playbook, which prepares the host and installs the container stack; the resulting service includes configurable databases, TLS/routing, and optional integrations. Backup setup and Nextcloud feature configuration are distinct branches. The README documents capabilities and configuration, but no source excerpts were provided, so internal task-to-task calls and deployment details are not verified here.

Main entry points: [`nextdocker.yml`](https://github.com/reinernippes/nextcloud_on_docker/blob/master/nextdocker.yml) (Deployment Playbook), [`roles/docker_container/tasks/main.yml`](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/main.yml) (Container Deployment), [`roles/nextcloud_config/tasks/main.yml`](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/main.yml) (Nextcloud Configuration), [`roles/prep_backup/tasks/main.yml`](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_backup/tasks/main.yml) (Backup Tool Setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Deployment"]
  node_configuration["Instance Configuration"]
  node_playbook["Deployment Playbook<br/>[nextdocker.yml]"]
end

subgraph group_host["Host Preparation"]
  node_osprep["OS Preparation<br/>[main.yml]"]
  node_dockerprep["Docker Preparation<br/>[main.yml]"]
  node_firewall["Firewall Setup<br/>[main.yml]"]
end

subgraph group_stack["Container Stack"]
  node_containers["Container Deployment<br/>[main.yml]"]
  node_database[("Database Service<br/>[database.yml]")]
  node_proxy["Traefik Routing<br/>[traefik.yml]"]
  node_nextcloud["Nextcloud Service<br/>[nextcloud.yml]"]
  node_adminer["Adminer<br/>[adminer.yml]"]
  node_portainer["Portainer<br/>[portainer.yml]"]
end

subgraph group_features["Nextcloud Features"]
  node_nextconfig["Nextcloud Configuration<br/>[main.yml]"]
  node_office["Online Office"]
  node_onlyoffice["ONLYOFFICE"]
  node_talk["Talk TURN Setup<br/>[talk.yml]"]
  node_search["Full-Text Search<br/>[fulltextsearch.yml]"]
end

subgraph group_backup["Backup"]
  node_backupsetup["Backup Tool Setup<br/>[main.yml]"]
  node_backupscript["Backup Script"]
  node_backupservice[("Backup Storage")]
end

node_operator(("Operator"))

node_operator -->|"configures"| node_configuration
node_operator -->|"runs"| node_playbook
node_configuration -->|"configures"| node_playbook
node_playbook -.->|"prepares host"| node_osprep
node_playbook -.->|"prepares Docker"| node_dockerprep
node_playbook -.->|"configures firewall"| node_firewall
node_playbook -->|"deploys stack"| node_containers
node_containers -.->|"deploys"| node_database
node_containers -.->|"deploys"| node_proxy
node_containers -.->|"deploys"| node_nextcloud
node_containers -->|"optionally deploys"| node_adminer
node_containers -->|"optionally deploys"| node_portainer
node_playbook -.->|"configures features"| node_nextconfig
node_nextconfig -->|"optionally configures"| node_office
node_nextconfig -->|"optionally configures"| node_onlyoffice
node_nextconfig -->|"optionally configures"| node_talk
node_nextconfig -->|"optionally configures"| node_search
node_playbook -->|"sets up backups"| node_backupsetup
node_backupsetup -.->|"templates"| node_backupscript
node_backupsetup -->|"configures"| node_backupservice

click node_configuration "https://github.com/reinernippes/nextcloud_on_docker/blob/master/inventory"
click node_playbook "https://github.com/reinernippes/nextcloud_on_docker/blob/master/nextdocker.yml"
click node_osprep "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_os/tasks/main.yml"
click node_dockerprep "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_docker/tasks/main.yml"
click node_firewall "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_ufw/tasks/main.yml"
click node_containers "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/main.yml"
click node_database "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/database.yml"
click node_proxy "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/traefik.yml"
click node_nextcloud "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/nextcloud.yml"
click node_adminer "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/adminer.yml"
click node_portainer "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/portainer.yml"
click node_nextconfig "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/main.yml"
click node_office "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/configure_collabora.yml"
click node_onlyoffice "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/configure_onlyoffice.yml"
click node_talk "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/talk.yml"
click node_search "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/fulltextsearch.yml"
click node_backupsetup "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_backup/tasks/main.yml"
click node_backupscript "https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_backup/templates/backup_nextcloud.sh.j2"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_configuration,node_playbook toneBlue
class node_osprep,node_dockerprep,node_firewall toneAmber
class node_containers,node_database,node_proxy,node_nextcloud,node_adminer,node_portainer toneMint
class node_nextconfig,node_office,node_onlyoffice,node_talk,node_search toneRose
class node_backupsetup,node_backupscript,node_backupservice,node_operator toneIndigo
```

## Components

### Deployment

- [Instance Configuration](https://github.com/reinernippes/nextcloud_on_docker/blob/master/inventory): `inventory`
- [Deployment Playbook](https://github.com/reinernippes/nextcloud_on_docker/blob/master/nextdocker.yml): `nextdocker.yml`

### Host Preparation

- [OS Preparation](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_os/tasks/main.yml): `roles/prep_os/tasks/main.yml`
- [Docker Preparation](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_docker/tasks/main.yml): `roles/prep_docker/tasks/main.yml`
- [Firewall Setup](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_ufw/tasks/main.yml): `roles/prep_ufw/tasks/main.yml`

### Container Stack

- [Container Deployment](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/main.yml): `roles/docker_container/tasks/main.yml`
- [Database Service](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/database.yml): `roles/docker_container/tasks/database.yml`
- [Traefik Routing](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/traefik.yml): `roles/docker_container/tasks/traefik.yml`
- [Nextcloud Service](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/nextcloud.yml): `roles/docker_container/tasks/nextcloud.yml`
- [Adminer](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/adminer.yml): `roles/docker_container/tasks/adminer.yml`
- [Portainer](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/docker_container/tasks/portainer.yml): `roles/docker_container/tasks/portainer.yml`

### Nextcloud Features

- [Nextcloud Configuration](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/main.yml): `roles/nextcloud_config/tasks/main.yml`
- [Online Office](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/configure_collabora.yml): `roles/nextcloud_config/tasks/configure_collabora.yml`
- [ONLYOFFICE](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/configure_onlyoffice.yml): `roles/nextcloud_config/tasks/configure_onlyoffice.yml`
- [Talk TURN Setup](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/talk.yml): `roles/nextcloud_config/tasks/talk.yml`
- [Full-Text Search](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/nextcloud_config/tasks/fulltextsearch.yml): `roles/nextcloud_config/tasks/fulltextsearch.yml`

### Backup

- [Backup Tool Setup](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_backup/tasks/main.yml): `roles/prep_backup/tasks/main.yml`
- [Backup Script](https://github.com/reinernippes/nextcloud_on_docker/blob/master/roles/prep_backup/templates/backup_nextcloud.sh.j2): `roles/prep_backup/templates/backup_nextcloud.sh.j2`
- **Backup Storage**

### Other components

- **Operator**

## Connections

- Operator → Instance Configuration: configures (evidence: `README.md`)
- Operator → Deployment Playbook: runs (evidence: `README.md`)
- Instance Configuration → Deployment Playbook: configures (evidence: `README.md`)
- Deployment Playbook → OS Preparation: prepares host
- Deployment Playbook → Docker Preparation: prepares Docker
- Deployment Playbook → Firewall Setup: configures firewall
- Deployment Playbook → Container Deployment: deploys stack (evidence: `README.md`)
- Container Deployment → Database Service: deploys
- Container Deployment → Traefik Routing: deploys
- Container Deployment → Nextcloud Service: deploys
- Container Deployment → Adminer: optionally deploys (evidence: `README.md`)
- Container Deployment → Portainer: optionally deploys (evidence: `README.md`)
- Deployment Playbook → Nextcloud Configuration: configures features
- Nextcloud Configuration → Online Office: optionally configures (evidence: `README.md`)
- Nextcloud Configuration → ONLYOFFICE: optionally configures (evidence: `README.md`)
- Nextcloud Configuration → Talk TURN Setup: optionally configures (evidence: `README.md`)
- Nextcloud Configuration → Full-Text Search: optionally configures (evidence: `README.md`)
- Deployment Playbook → Backup Tool Setup: sets up backups (evidence: `README.md`)
- Backup Tool Setup → Backup Script: templates
- Backup Tool Setup → Backup Storage: configures (evidence: `README.md`)
