Nextcloud Automated Installer

[!CAUTION] This project is for educational and ethical cybersecurity purposes only. The author is not responsible for any misuse or damage caused by this software.

---

🧠 Overview

Este proyecto es un instalador automatizado de Nextcloud para entornos Ubuntu, construido íntegramente en Bash. A partir del análisis de la estructura del repositorio y sus archivos clave, el script principal (src/setup.sh) orquesta el despliegue completo de un stack LAMP (Linux + Apache + MySQL/MariaDB + PHP) y la configuración de Nextcloud sobre él, a través de un asistente interactivo por menú que guía al administrador en cada etapa del proceso.

El proyecto sigue una estrategia DevSecOps centrada en la automatización del despliegue y la seguridad de la infraestructura, garantizando que cada componente esté configurado siguiendo las mejores prácticas de la industria.

---

⚙️ Features

• Asistente interactivo por menú — setup.sh presenta un menú modular que permite ejecutar cada fase del despliegue de forma independiente o secuencial.
• Instalación del stack LAMP — Automatiza la instalación y configuración de Apache2 como servidor web, MySQL/MariaDB como base de datos y PHP con las extensiones requeridas por Nextcloud.
• Despliegue de Nextcloud — Descarga, descomprime y enlaza Nextcloud al directorio web de Apache, configurando la base de datos y los parámetros de red del servidor.
• Hardening de seguridad — Aplica endurecimiento de permisos en directorios críticos de Nextcloud (/var/www/html/nextcloud/) para cumplir con las recomendaciones de seguridad oficiales.
• Diagnóstico del sistema — Opción de verificación de estado que reporta el estado de los servicios activos (Apache2, MySQL, PHP) y recursos del sistema.
• Documentación técnica detallada — Guías completas en la carpeta docs/ que cubren desde la arquitectura hasta el mantenimiento del sistema.
• Documentación técnica separada — Carpeta docs/ con documentación detallada del proceso de despliegue, independiente del código fuente.

---

🛠️ Tech Stack

Componente	Tecnología
Sistema Operativo	Ubuntu 20.04 LTS o superior
Lenguaje de scripting	Bash / Shell
Servidor web	Apache2
Base de datos	MySQL / MariaDB
Lenguaje backend	PHP (con extensiones Nextcloud)
Aplicación desplegada	Nextcloud (plataforma self-hosted)
Control de versiones	Git (GitHub)

---

📦 Installation

Requisitos previos

• Ubuntu Server 20.04 LTS o superior
• Acceso de superusuario (sudo)
• Conexión a Internet activa
• Al menos 2 GB de RAM y 10 GB de espacio en disco (recomendado para Nextcloud)

Instalación

# 1. Clonar el repositorio
git clone https://github.com/devsebastian44/Nextcloud.git
cd Nextcloud

# 2. Otorgar permisos de ejecución al script principal
chmod +x src/setup.sh

# 3. Ejecutar el instalador con privilegios de root
sudo ./src/setup.sh

⚠️ Se recomienda ejecutar el instalador sobre un servidor limpio o una máquina virtual dedicada. No ejecutar sobre sistemas con servicios web ya configurados sin revisar previamente los archivos de configuración en configs/.

---

▶️ Usage

Al ejecutar sudo ./src/setup.sh, se presenta un menú interactivo con las siguientes opciones:

╔══════════════════════════════════════╗
║   Nextcloud Professional Installer  ║
╠══════════════════════════════════════╣
║  [1] Instalar Requisitos             ║
║  [2] Configurar Nextcloud            ║
║  [3] Configurar Seguridad            ║
║  [4] Verificar Estado                ║
║  [0] Salir                           ║
╚══════════════════════════════════════╝

Flujo recomendado de ejecución:

# Paso 1 — Instalar el stack LAMP (Apache, MySQL, PHP)
Seleccionar opción [1]

# Paso 2 — Desplegar y vincular Nextcloud con la base de datos
Seleccionar opción [2]

# Paso 3 — Aplicar hardening de permisos y configuración de seguridad
Seleccionar opción [3]

# Paso 4 — Verificar que todos los servicios estén activos
Seleccionar opción [4]

Verificación manual post-instalación:

# Estado de Apache2
sudo systemctl status apache2

# Estado de MySQL/MariaDB
sudo systemctl status mysql

# Acceder a Nextcloud desde el navegador
http://<IP_DEL_SERVIDOR>/

---

📁 Project Structure

Nextcloud/
│
├── src/
│   └── setup.sh                   # Script principal del instalador:
│                                  # menú interactivo, instalación LEMP,
│                                  # despliegue y configuración de Nextcloud
│
├── docs/                          # Documentación técnica detallada:
│                                  # guías de configuración, diagramas
│                                  # de arquitectura y flujos de despliegue
│
├── .gitignore                     # Exclusiones de Git: archivos de entorno,
│                                  # configs reales y artefactos privados
│
├── LICENSE                        # Licencia GPL-3.0
└── README.md                      # Documentación pública del repositorio

📌 El repositorio incluye adicionalmente: configs/ (plantillas de configuración) y tests/ (validaciones y pruebas unitarias).

---

🔐 Security

Este proyecto despliega una plataforma de colaboración privada. Se consideran las siguientes implicaciones de seguridad:

• Hardening de permisos — El script aplica restricciones de propiedad y permisos sobre los directorios de Nextcloud (www-data, 750/640) para limitar la exposición de archivos sensibles.
• Separación de credenciales — Las configuraciones reales de base de datos y parámetros de red son filtradas por el pipeline de sanitización antes de la publicación pública; nunca deben commitearse credenciales reales.
• Apache como servidor seguro — Se recomienda configurar HTTPS con certificado SSL/TLS (Let's Encrypt o autofirmado) sobre Apache antes de exponer Nextcloud a redes públicas.
• PHP hardening — Verificar que php.ini tenga deshabilitadas directivas como expose_php, display_errors y configurados límites de subida adecuados (upload_max_filesize, post_max_size).
• MySQL/MariaDB — Ejecutar mysql_secure_installation tras la instalación para eliminar usuarios anónimos, deshabilitar el acceso root remoto y eliminar bases de datos de prueba.
• Firewall — Se recomienda configurar ufw para permitir únicamente los puertos necesarios (80, 443) y bloquear accesos directos al puerto de base de datos (3306).
• Uso responsable — Este proyecto está diseñado para entornos educativos, laboratorios y despliegues controlados. Revisar y adaptar todos los archivos de configuración antes de cualquier uso en producción.

⚠️ Este repositorio contiene la versión completa y funcional del instalador. Se recomienda revisar los archivos de configuración en configs/ antes del despliegue.

---

🧪 Testing

El proyecto incluye scripts de validación para asegurar la calidad del código:

# Ejecutar verificación de sintaxis
./tests/test_syntax.sh

# Ejecutar linting (requiere shellcheck)
./tests/test_lint.sh

Los tests se ejecutan automáticamente en cada Pull Request mediante GitHub Actions.

---

🤝 Contributing

¡Las contribuciones son bienvenidas! Si deseas mejorar el instalador:

1. Fork el proyecto.
2. Crea una rama para tu mejora (git checkout -b feature/amazing-feature).
3. Realiza tus cambios y asegúrate de que los tests pasen.
4. Commit tus cambios siguiendo el estándar Conventional Commits.
5. Push a la rama (git push origin feature/amazing-feature).
6. Abre un Pull Request.

---

🚀 Roadmap

Posibles mejoras identificadas a partir del análisis del código y la arquitectura actual:

• Soporte HTTPS automático — Integrar Certbot con Let's Encrypt directamente desde el menú del instalador.
• Selección de versión de Nextcloud — Permitir al usuario especificar la versión a instalar en lugar de usar siempre la más reciente.
• Soporte para MariaDB y PostgreSQL — Ampliar la opción de base de datos más allá de MySQL.
• Modo headless / no interactivo — Añadir soporte para flags de línea de comandos que permitan ejecución automatizada sin menú (útil para CI/CD).
• Integración con Redis — Configurar Redis como caché de sesiones y archivos para mejorar el rendimiento de Nextcloud.
• Script de backup automatizado — Añadir un módulo de respaldo para datos de Nextcloud y la base de datos.
• Soporte multi-distro — Extender compatibilidad a Debian y CentOS/Rocky Linux además de Ubuntu.

---

📄 License

Este proyecto está bajo la licencia GNU General Public License v3.0 (GPL-3.0).

GPL-3.0 License — Copyright (c) devsebastian44
Se permite el uso, modificación y distribución bajo los términos de la GPL v3.
Las versiones derivadas deben mantener la misma licencia y publicar el código fuente.

---

👨‍💻 Author

Sebastian GitHub: @devsebastian44

Proyecto desarrollado con fines educativos y de automatización de infraestructura, siguiendo principios DevSecOps para el despliegue seguro de plataformas self-hosted.