# Gancio

Estibado de Gancio para Sindominio

## Instalación

Crear un fichero .env con los parámetros oportunos

```
 $ cp .env.sample .env
```

Edita las variables del fichero:

```
GANCIO_DATA_PATH="./data" # Volumen de los datos de gancio
GANCIO_PORT=13120 # Puerto
GANCIO_USER_GROUP="1000:1000" # Usuario de ejecución de gancio
SMTP_HOST="smtp.sindominio.net" # Servidor de correo SMTP
SMTP_PORT="587" # Puerto SMTP (25,587,465)
SMTP_SECURE="false" # TLS or not
SMTP_USER="gancio@sindominio.net" # Cuenta de correo para el envio saliente de mensajes de Gancio
SMTP_PASS="secret" # Password de la cuenta de correo
```

Crea la carpeta que hace de volumen con los permisos y propietarios:

```
$ mkdir data
$ sudo chown 1000:1000 data
```

Al levantar el servicio por primera vez un formulario de instalación te ofrecerá configurar los siguientes datos:

![Formulario de configuración de Gancio](documentation/img/image000.png)

* __Correo de administración:__ Este correo recibirá las peticiones de acceso de nuevas usuarias o las de moderación. **NO es la cuenta de administración**, es únicament el correo que recibe las peticiones y otras notificaciones en la instancia. La cuenta de administración se genera al realizar le primer registro.
* __Título de la instancia:__ Nombre que tendrá la instancia

Al finalizar el formulario, si todo es correcto, en 30 segundos la web te redireccionará a tu instancia de Gancio.

![Configuración correcta](documentation/img/image001.png)

Si tu navegador bloquea código javascript deberás hacerlo a mano volviendo a actualizar la página.

![Instancia de Gancio](documentation/img/image002.png)

Tras eso, deberas crear la cuenta de administración. Para ello, Gancio crea como administradora la primera cuenta generada en el sistema.

Accede a la sección _Login_ de tu instancia:

![Login Gancio para recuperar contraseña](documentation/img/image003.png)

Y luego pulsa sobre **NOT REGISTERED?**

![Register account Gancio para recuperar contraseña](documentation/img/image004.png)

Rellena los datos y, al ser la primera cuenta creada, accederás directamente a la sección de administración.

Además, en unos minutos, deberías recibir un correo para recuperar la contraseña.

Más información de como administrar y trabajar con __Gancio__ en la web oficial [https://gancio.org/]()

# Links

Basado en:

* https://git.sindominio.net/gancio/docker-gancio
* https://framagit.org/les/gancio

# Contacto

Email: admin[at]sindominio.net