Configuración del Servidor¶

Usando la imagen de Docker por defecto, toda la configuración necesaria se puede realizar desde el navegador. Sin embargo, dependiendo del despliegue, puede ser necesario personalizar la configuración del servidor.

Esta página enumera todos los métodos para cambiar la configuración y todas las opciones de configuración existentes.

Archivo de configuración vs. variables de entorno¶

Para los ajustes, puedes utilizar un archivo de configuración o variables de entorno.

Cuando usas la configuración basada en Docker Compose, puedes incluir un archivo de configuración agregando el siguiente elemento de lista bajo la clave volumes: en el bloque grampsweb::

      - /path/to/config.cfg:/app/config/config.cfg

donde /path/to/config.cfg es la ruta al archivo de configuración en el sistema de archivos de tu servidor (el lado derecho se refiere a la ruta en el contenedor y no debe ser cambiado).

Al usar variables de entorno,

prefija cada nombre de ajuste con GRAMPSWEB_ para obtener el nombre de la variable de entorno
Usa dobles guiones bajos para los ajustes de diccionario anidados, por ejemplo, GRAMPSWEB_THUMBNAIL_CACHE_CONFIG__CACHE_DEFAULT_TIMEOUT establecerá el valor de la opción de configuración THUMBNAIL_CACHE_CONFIG['CACHE_DEFAULT_TIMEOUT']

Ten en cuenta que las opciones de configuración establecidas a través del entorno tienen prioridad sobre las que están en el archivo de configuración. Si ambas están presentes, la variable de entorno "gana".

Ajustes de configuración existentes¶

Las siguientes opciones de configuración existen.

Ajustes requeridos¶

Clave	Descripción
`TREE`	El nombre de la base de datos del árbol genealógico a utilizar. Muestra los árboles disponibles con `gramps -l`. Si no existe un árbol con este nombre, se creará uno nuevo vacío.
`SECRET_KEY`	La clave secreta para flask. La clave secreta no debe ser compartida públicamente. Cambiarla invalidará todos los tokens de acceso.
`USER_DB_URI`	La URL de la base de datos de usuarios. Se permite cualquier URL compatible con SQLAlchemy.

Info

Puedes generar una clave secreta segura, por ejemplo, con el comando

python3 -c "import secrets;print(secrets.token_urlsafe(32))"

Ajustes opcionales¶

Clave	Descripción
`MEDIA_BASE_DIR`	Ruta a usar como directorio base para archivos multimedia, sobrescribiendo el directorio base de medios establecido en Gramps. Al usar S3, debe tener la forma `s3://<bucket_name>`
`SEARCH_INDEX_DB_URI`	URL de la base de datos para el índice de búsqueda. Solo se permiten `sqlite` o `postgresql` como backends. Por defecto es `sqlite:///indexdir/search_index.db`, creando un archivo SQLite en la carpeta `indexdir` relativa a la ruta donde se ejecuta el script.
`STATIC_PATH`	Ruta para servir archivos estáticos (por ejemplo, un frontend web estático).
`BASE_URL`	URL base donde se puede acceder a la API (por ejemplo, `https://mygramps.mydomain.com/`). Esto es necesario, por ejemplo, para construir enlaces de restablecimiento de contraseña correctos.
`CORS_ORIGINS`	Orígenes desde donde se permiten solicitudes CORS. Por defecto, todos están deshabilitados. Usa `"*"` para permitir solicitudes de cualquier dominio.
`EMAIL_HOST`	Host del servidor SMTP (por ejemplo, para enviar correos electrónicos de restablecimiento de contraseña).
`EMAIL_PORT`	Puerto del servidor SMTP. Por defecto es 465.
`EMAIL_HOST_USER`	Nombre de usuario del servidor SMTP.
`EMAIL_HOST_PASSWORD`	Contraseña del servidor SMTP.
`EMAIL_USE_TLS`	Booleano, si se debe usar TLS para enviar correos electrónicos. Por defecto es `True`. Al usar STARTTLS, establece esto en `False` y usa un puerto diferente de 25.
`DEFAULT_FROM_EMAIL`	Dirección "De" para correos electrónicos automatizados.
`THUMBNAIL_CACHE_CONFIG`	Diccionario con ajustes para la caché de miniaturas. Consulta Flask-Caching para posibles ajustes.
`REQUEST_CACHE_CONFIG`	Diccionario con ajustes para la caché de solicitudes. Consulta Flask-Caching para posibles ajustes.
`PERSISTENT_CACHE_CONFIG`	Diccionario con ajustes para la caché persistente, utilizada por ejemplo para telemetría. Consulta Flask-Caching para posibles ajustes.
`CELERY_CONFIG`	Ajustes para la cola de tareas en segundo plano de Celery. Consulta Celery para posibles ajustes.
`REPORT_DIR`	Directorio temporal donde se almacenará la salida de los informes de Gramps.
`EXPORT_DIR`	Directorio temporal donde se almacenará la salida de la exportación de la base de datos de Gramps.
`REGISTRATION_DISABLED`	Si `True`, deshabilita el registro de nuevos usuarios (por defecto `False`).
`DISABLE_TELEMETRY`	Si `True`, deshabilita la telemetría de estadísticas (por defecto `False`). Consulta telemetría para más detalles.

Info

Al usar variables de entorno para la configuración, las opciones booleanas como EMAIL_USE_TLS deben ser la cadena true o false (¡sensible a mayúsculas!).

Ajustes solo para la base de datos backend de PostgreSQL¶

Esto es necesario si has configurado tu base de datos de Gramps para trabajar con el complemento de PostgreSQL.

Clave	Descripción
`POSTGRES_USER`	El nombre de usuario para la conexión a la base de datos.
`POSTGRES_PASSWORD`	La contraseña para el usuario de la base de datos.

Ajustes relevantes para alojar múltiples árboles¶

Los siguientes ajustes son relevantes al alojar múltiples árboles.

Clave	Descripción
`MEDIA_PREFIX_TREE`	Booleano, si se debe usar una subcarpeta separada para los archivos multimedia de cada árbol. Por defecto es `False`, pero se recomienda encarecidamente usar `True` en una configuración de múltiples árboles.
`NEW_DB_BACKEND`	El backend de base de datos a utilizar para los árboles genealógicos recién creados. Debe ser uno de `sqlite`, `postgresql` o `sharedpostgresql`. Por defecto es `sqlite`.
`POSTGRES_HOST`	El nombre del host del servidor PostgreSQL utilizado para crear nuevos árboles cuando se usa una configuración de múltiples árboles con el backend SharedPostgreSQL.
`POSTGRES_PORT`	El puerto del servidor PostgreSQL utilizado para crear nuevos árboles cuando se usa una configuración de múltiples árboles con el backend SharedPostgreSQL.

Ajustes para autenticación OIDC¶

Estos ajustes son necesarios si deseas usar autenticación OpenID Connect (OIDC) con proveedores externos. Para instrucciones de configuración detalladas y ejemplos, consulta Autenticación OIDC.

Clave	Descripción
`OIDC_ENABLED`	Booleano, si se debe habilitar la autenticación OIDC. Por defecto es `False`.
`OIDC_ISSUER`	URL del emisor del proveedor OIDC (para proveedores OIDC personalizados).
`OIDC_CLIENT_ID`	ID de cliente OAuth (para proveedores OIDC personalizados).
`OIDC_CLIENT_SECRET`	Secreto de cliente OAuth (para proveedores OIDC personalizados).
`OIDC_NAME`	Nombre de visualización personalizado para el proveedor. Por defecto es "OIDC".
`OIDC_SCOPES`	Alcances de OAuth. Por defecto es "openid email profile".
`OIDC_USERNAME_CLAIM`	La reclamación a usar para el nombre de usuario. Por defecto es "preferred_username".
`OIDC_OPENID_CONFIG_URL`	Opcional: URL al endpoint de configuración de OpenID Connect (si no se usa el estándar `/.well-known/openid-configuration`).
`OIDC_DISABLE_LOCAL_AUTH`	Booleano, si se debe deshabilitar la autenticación local de nombre de usuario/contraseña. Por defecto es `False`.
`OIDC_AUTO_REDIRECT`	Booleano, si se debe redirigir automáticamente a OIDC cuando solo se configura un proveedor. Por defecto es `False`.

Proveedores OIDC integrados¶

Para proveedores integrados (Google, Microsoft, GitHub), usa estos ajustes:

Clave	Descripción
`OIDC_GOOGLE_CLIENT_ID`	ID de cliente para Google OAuth.
`OIDC_GOOGLE_CLIENT_SECRET`	Secreto de cliente para Google OAuth.
`OIDC_MICROSOFT_CLIENT_ID`	ID de cliente para Microsoft OAuth.
`OIDC_MICROSOFT_CLIENT_SECRET`	Secreto de cliente para Microsoft OAuth.
`OIDC_GITHUB_CLIENT_ID`	ID de cliente para GitHub OAuth.
`OIDC_GITHUB_CLIENT_SECRET`	Secreto de cliente para GitHub OAuth.

Mapeo de Roles OIDC¶

Estos ajustes te permiten mapear grupos/roles OIDC de tu proveedor de identidad a roles de usuario de Gramps Web:

Clave	Descripción
`OIDC_ROLE_CLAIM`	El nombre de la reclamación en el token OIDC que contiene los grupos/roles del usuario. Por defecto es "groups".
`OIDC_GROUP_ADMIN`	El nombre del grupo/rol de tu proveedor OIDC que se mapea al rol "Admin" de Gramps.
`OIDC_GROUP_OWNER`	El nombre del grupo/rol de tu proveedor OIDC que se mapea al rol "Owner" de Gramps.
`OIDC_GROUP_EDITOR`	El nombre del grupo/rol de tu proveedor OIDC que se mapea al rol "Editor" de Gramps.
`OIDC_GROUP_CONTRIBUTOR`	El nombre del grupo/rol de tu proveedor OIDC que se mapea al rol "Contributor" de Gramps.
`OIDC_GROUP_MEMBER`	El nombre del grupo/rol de tu proveedor OIDC que se mapea al rol "Member" de Gramps.
`OIDC_GROUP_GUEST`	El nombre del grupo/rol de tu proveedor OIDC que se mapea al rol "Guest" de Gramps.

Ajustes solo para funciones de IA¶

Estos ajustes son necesarios si deseas usar funciones impulsadas por IA como chat o búsqueda semántica.

Clave	Descripción
`LLM_BASE_URL`	URL base para la API de chat compatible con OpenAI. Por defecto es `None`, lo que utiliza la API de OpenAI.
`LLM_MODEL`	El modelo a utilizar para la API de chat compatible con OpenAI. Si no se establece (el valor por defecto), el chat está deshabilitado.
`VECTOR_EMBEDDING_MODEL`	El modelo de Sentence Transformers a utilizar para incrustaciones de vectores de búsqueda semántica. Si no se establece (el valor por defecto), la búsqueda semántica y el chat están deshabilitados.
`LLM_MAX_CONTEXT_LENGTH`	Límite de caracteres para el contexto del árbol genealógico proporcionado al LLM. Por defecto es 50000.

Ejemplo de archivo de configuración¶

Un archivo de configuración mínimo para producción podría verse así: ```python TREE="Mi Árbol Genealógico" BASE_URL="https://mytree.example.com" SECRET_KEY="..." # tu clave secreta USER_DB_URI="sqlite:////path/to/users.sqlite" EMAIL_HOST="mail.example.com" EMAIL_PORT=465 EMAIL_USE_TLS=True EMAIL_HOST_USER="gramps@example.com" EMAIL_HOST_PASSWORD="..." # tu contraseña SMTP DEFAULT_FROM_EMAIL="gramps@example.com"