.. MaadiX Documentación documentation master file, created by
   sphinx-quickstart on Wed Sep  2 13:28:18 2020.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. toctree::
   :maxdepth: 2
   :hidden:
   :caption: Generales

   panel-de-control
   updates
   security
   2fa
   users
   dominios
   dns
   ipv6
   fqdn
   trash
   notifications
   fail2ban
   create-web
   wordpress
   php-fpm
   email

.. toctree::
   :maxdepth: 2
   :hidden:
   :caption: Aplicaciones

   applications
   nginx-apache
   cryptpad
   dolibarr
   etherpad
   jitsi-meet
   lool
   limesurvey
   mail-man
   mailtrain
   mastodon
   mumble
   mysql
   ncloud
   odoo
   onlyoffice
   peertube
   coturn
   spamassassin
   tor
   vpn
   zeyple-pgp

.. toctree::
   :maxdepth: 2
   :hidden:
   :caption: Extras

   borg
   luks


Tutoriales y documentación
==========================

En esta web encontrarás la documentación completa sobre el uso de `MaadiX <https://maadix.net/>`__.

Estás consultando la documentación de la última release. Puedes consultar versiones anteriores desde el desplegable al fondo del menú izquierdo.

¿Qué es MaadiX?
---------------

MaadiX es una herramienta que permite instalar, actualizar y administrar aplicaciones de código
abierto en un servidor propio, desde una interfaz gráfica intuitiva y sin necesidad de conocimientos
técnicos. Con un simple clic es posible habilitar aplicaciones como Jitsi Meet, OpenVPN, Etherpad,
servidor de correo o Nextcloud, disponiendo así de una nube propia, independiente, privada y segura.

Las actualizaciones del sistema se publican periódicamente y deben aplicarse desde el panel de
control cada vez que se anuncian. El proceso es sencillo —basta un clic—, pero es imprescindible
realizarlo para mantener el sistema al día y seguro.

Panel de Control
----------------

El panel de control es la interfaz que permite ejecutar distintas tareas
de administración y mantenimiento sin necesidad de ejecutar comandos en
la terminal. Podrás instalar y administrar aplicaciones, crear cuentas,
dominios, cuentas de correo electrónico, otorgar acceso al sistema a
otras personas con diferentes tipos de privilegios, ver estadísticas
básicas del sistema entre otras operaciones.

Los datos
---------

Todos los servidores tienen instalado un directorio donde se almacenarán
los datos de cuentas, dominios, cuentas de correo electrónico y
aplicaciones; técnicamente hablando, se trata de un directorio
`OpenLDAP <https://es.wikipedia.org/wiki/OpenLDAP>`__.

El panel de control es la interfaz gráfica para administrar este
directorio OpenLDAP y el sistema sacará del mismo la información
necesaria para su configuración. De esta forma, el panel de control no
necesita privilegios para escribir directamente esta información en el
sistema.

Haciendo uso de tareas programadas en el sistema (*cronjobs*) se
comprueba si hay cambios en el directorio de OpenLDAP (nuevas
configuraciones o nuevas aplicaciones para instalar) y en caso
afirmativo se aplican los cambios a través de
`Puppet <https://es.wikipedia.org/wiki/Puppet_(software)>`__. Esta
implementación de Puppet es lo que permite poder aplicar cambios en el
sistema sin tener acceso a los servidores ni a datos sensibles de lxs
usuarixs.

Puedes encontrar más detalles sobre la tecnología que usa Maadix
`aquí <https://maadix.net/es/tecnologia>`__.

Cambios entre versiones 
-----------------------

Si has actualizado la versión de MaadiX desde una instalación anterior,
notarás algunos cambios no solo en la apariencia de la interfaz gráfica,
sino también en alguna funcionalidad.

Puedes consultar versiones anteriores desplegando el menú que encuentras
al fondo del menú izquierdo.