# Stirling PDF

Servicio self-hosted para manipular PDF.

## Qué hace y configuración

Stirling PDF combina, divide, convierte, firma y transforma documentos desde una interfaz web. `SECURITY_ENABLELOGIN=false` deja la autenticación en Traefik + Authentik; no debe publicarse una ruta alternativa que evite ese middleware.

- `STIRLING_PDF_IMAGE` fija la versión.
- `STIRLING_PDF_DOMAIN` define el dominio público.
- `STIRLING_PDF_CONFIG_PATH` guarda configuración.
- `STIRLING_PDF_CUSTOM_PATH` contiene personalización.
- `STIRLING_PDF_LOGS_PATH` conserva logs y debe tener rotación.
- `STIRLING_PDF_PIPELINE_PATH` guarda automatizaciones.

Los documentos procesados pueden ser confidenciales. Revisa retención de temporales, permisos de los volúmenes y evita registrar nombres o contenido sensible.

- URL: `https://pdf.sherlockhomeless.net/`
- Contenedor: `stirling-pdf`
- Datos persistentes: `/opt/stirling-pdf/`
- Red externa: `proxy`
- Acceso: protegido por Authentik desde Traefik

## Operacion

```bash
docker compose --env-file .env config
docker compose --env-file .env up -d
docker compose --env-file .env logs -f
```