diff --git a/docs/Home.md b/docs/Home.md new file mode 100644 index 0000000..a0de8bf --- /dev/null +++ b/docs/Home.md @@ -0,0 +1,58 @@ +# Inicio — Infra Portainer + +Bienvenido a la wiki del repositorio **infra-portainer**. Esta página es la primera entrada y contiene la información esencial para desplegar Portainer usando Docker Compose. + +--- + +## Propósito + +Este repositorio contiene la infraestructura mínima para desplegar Portainer Community Edition (CE) con Docker Compose. Está pensado para facilitar la administración de contenedores y stacks en entornos pequeños o de laboratorio. + +## Contenido principal + +- `docker-compose.yaml`: definición del servicio Portainer (puertos, volúmenes y variables). +- `.env` (variables de entorno): fichero donde pueden definirse variables de entorno (contraseñas, rutas, etc.). + +## Puertos expuestos + +- 9443: Interfaz web segura (HTTPS) de Portainer. +- 8000: Puerto para el agente Edge (opcional). + +## Despliegue rápido (modo local) + +1. Sitúate en la carpeta del repositorio: + +```powershell +cd C:\Users\gustavo.roales.ICT-IBERIA\repos\infra-portainer +``` + +2. (Opcional) revisa `.env` y adapta variables si existen. + +3. Arranca con Docker Compose: + +```powershell +docker compose up -d +# o, en sistemas con docker-compose clásico: +docker-compose up -d +``` + +4. Verifica que el contenedor está corriendo: + +```powershell +docke ps --filter name=portainer +``` + +5. Accede a la interfaz en: https://:9443 + +## Buenas prácticas + +- Asegúrate de tener un volumen persistente para `/data` (ya definido en `docker-compose.yaml`) para mantener la configuración. +- No exponer puertos innecesarios a Internet sin un proxy y HTTPS correctamente configurado. + +## Contribuciones a la documentación + +Puedes editar esta documentación directamente en `docs/` dentro del repositorio y enviar tus cambios mediante Pull Request. Si en el futuro habilitas la wiki de Gitea, también podrás mantenerla allí. + +--- + +Si quieres, puedo añadir más páginas (instalación avanzada, certificados TLS, backup/restore del volumen `data`, integración con Traefik, etc.). ¿Qué te gustaría añadir en la siguiente página? \ No newline at end of file