Guía de instalación en macOS para digna Release 2026.11¶

Release: 2026.11

Última actualización: 7 de noviembre de 2026

Tabla de contenidos¶

1. Introducción
2. Requisitos del sistema
3. Preparación previa a la instalación
4. Configuración del servidor PostgreSQL
5. Configuración del servidor web
6. Instalación inicial
7. Configuración del backend
8. Configuración del dashboard
9. Ejecutar digna como servicio en segundo plano
10. Actualizar a una nueva versión

Introducción¶

Acerca de digna¶

digna es una plataforma completa impulsada por IA diseñada para optimizar la gestión de la calidad de los datos en diversos entornos de datos, como warehouses, lakes y lakehouses. Diseñada para ser altamente escalable y adaptable, digna aborda los desafíos modernos de datos mediante automatización, monitorización en tiempo real y detección de anomalías.

digna consta de dos componentes principales:

• digna: el núcleo de la aplicación, responsable de procesar los datos y realizar las comprobaciones de calidad. Combina el backend y la interfaz de línea de comandos en un único ejecutable, sustituyendo a los programas separados dignabackend y dignacli de versiones anteriores.
• dignadashboard: Una interfaz web alojada en un servidor web, que proporciona una forma amigable de interactuar con la plataforma digna y visualizar métricas de calidad de datos.

Novedades en la Release 2026.11¶

Esta versión añade digna Data Reconciliation, digna Agentic con el digna MCP Server y el digna Engine, que puede perfilar datos dentro de digna y comprobar la integridad referencial entre distintas tecnologías de bases de datos. Consulta las notas de la versión para obtener detalles completos.

Para una instalación, la versión trae un nuevo mecanismo de migración del repositorio, una sección [duckdb] opcional en config.toml para el digna Engine y un nuevo archivo de licencia. La sección de actualización trata cada uno de ellos.

¿Buscas Windows o Linux?¶

Esta guía cubre macOS. Para otras plataformas, consulta la Guía de instalación para Windows o la Guía de instalación para Linux.

Requisitos del sistema¶

Antes de comenzar la instalación, asegúrate de que tu sistema cumple los siguientes requisitos mínimos:

Opciones de instalación de la base de datos¶

Si PostgreSQL ya está instalado: Puedes añadir una nueva base de datos para digna en tu servidor PostgreSQL existente.

Si vas a instalar PostgreSQL en la misma máquina que digna:

Verificar tu arquitectura¶

Varios caminos en esta guía difieren entre Macs con Apple Silicon e Intel. Para comprobar cuál tienes, abre Terminal y ejecuta:

uname -m

• arm64 — Apple Silicon. Homebrew se instala en /opt/homebrew.
• x86_64 — Intel. Homebrew se instala en /usr/local.

Preparación previa a la instalación¶

Antes de instalar digna, asegúrate de que tres prerrequisitos clave estén presentes:

1. Homebrew – el gestor de paquetes usado para instalar los componentes que siguen
2. PostgreSQL Server – para almacenar métricas calculadas y datos de rendimiento
3. Servidor web – para alojar el Dashboard de digna

Si estos componentes aún no están configurados, sigue las secciones a continuación para instalarlos y configurarlos.

Instalación de Homebrew¶

Homebrew es el gestor de paquetes estándar para macOS y se usa en toda esta guía para instalar PostgreSQL y nginx.

Paso 1: Comprobar si Homebrew ya está instalado¶

Abre Terminal (pulsa Cmd + Space, escribe Terminal, pulsa Enter) y ejecuta:

brew --version

Si se devuelve un número de versión, continúa con la sección de Configuración del servidor PostgreSQL.

Paso 2: Instalar Homebrew¶

Si el comando no se encontró, instala Homebrew siguiendo las instrucciones en el sitio oficial de Homebrew. El instalador también instala las Xcode Command Line Tools si no están ya presentes.

Paso 3: Añadir Homebrew a tu PATH¶

En Apple Silicon, el instalador muestra dos comandos para añadir Homebrew a tu entorno de shell. Ejecútalos según se indique y luego confirma:

brew --prefix

Esto debería imprimir /opt/homebrew en Apple Silicon o /usr/local en Intel.

Configuración del servidor PostgreSQL¶

Si ya tienes PostgreSQL¶

Si PostgreSQL ya está instalado y en ejecución en tu máquina local o si estás usando un servidor PostgreSQL remoto gestionado, puedes saltar a la siguiente sección.

Opciones de instalación¶

macOS ofrece dos maneras sencillas de instalar PostgreSQL. Elige una:

• Homebrew — instalación desde la línea de comandos, recomendada para despliegues de servidor
• Postgres.app — instalación gráfica, conveniente para evaluación local

Instalar PostgreSQL con Homebrew¶

Paso 1: Instalar la fórmula de PostgreSQL¶

brew install postgresql@16

Paso 2: Añadir PostgreSQL a tu PATH¶

Las fórmulas versionadas de PostgreSQL son keg-only, lo que significa que Homebrew no enlaza sus comandos en tu PATH automáticamente. Añádelos tú mismo:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Paso 3: Iniciar el servicio PostgreSQL¶

brew services start postgresql@16

Esto inicia PostgreSQL inmediatamente y lo configura para que se inicie automáticamente cuando inicies sesión.

Paso 4: Verificar la instalación¶

psql --version

Deberías ver la versión de PostgreSQL si la instalación fue exitosa.

Paso 5: Conectarse al servidor¶

psql postgres

Paso 6: Confirmar el puerto¶

El puerto por defecto de PostgreSQL es 5432. Para confirmar el puerto en el que escucha tu servidor:

psql postgres -c "SHOW port;"

Anota el valor — lo necesitarás cuando configures el backend de digna.

Instalar PostgreSQL con Postgres.app¶

Si prefieres una instalación gráfica:

1. Descarga Postgres.app y arrástralo a tu carpeta Applications
2. Abre la app y haz clic en Initialize para crear un nuevo servidor
3. Sigue las instrucciones de la app para añadir sus herramientas de línea de comandos a tu PATH
4. Verifica la instalación:

psql --version

Postgres.app también crea un superusuario con el mismo nombre que tu cuenta de macOS.

Configuración del servidor web¶

digna requiere un servidor web para alojar el dashboard. Elige una de las siguientes opciones:

• nginx — instalado vía Homebrew, recomendado
• Apache httpd — incluido con macOS

Solo necesitas instalar y configurar uno de estos servidores.

Ambas secciones configuran dos cosas de las que depende el dashboard:

• Un fallback para aplicaciones de una sola página, de modo que al actualizar una URL del dashboard no devuelva 404
• Un tipo MIME para .md, para que los archivos Markdown se sirvan correctamente

Configuración de nginx¶

Resumen¶

nginx es un servidor web ligero y de alto rendimiento, bien adaptado para servir el dashboard estático de digna.

Instalación¶

brew install nginx

Iniciar nginx¶

brew services start nginx

Verificar la instalación¶

1. Abre tu navegador
2. Navega a http://localhost:8080
3. Deberías ver la página de bienvenida de nginx

Configurar un sitio para el dashboard¶

La configuración de nginx de Homebrew incluye todos los archivos en su directorio servers. Crea un archivo de configuración dedicado para digna ahí:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Pega lo siguiente, reemplazando /path/to/digna/dashboard por la ruta real a tu carpeta dashboard extraída:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

    # Servir archivos Markdown con el tipo MIME correcto.
    types {
        text/markdown  md;
    }

    # Fallback para aplicación de una sola página: las rutas desconocidas devuelven index.html
    # en lugar de un 404, de modo que las rutas del dashboard sobrevivan a una actualización del navegador.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Aplicar la configuración¶

Prueba la sintaxis de la configuración y luego recarga nginx:

nginx -t
brew services restart nginx

Configuración de Apache httpd¶

Resumen¶

macOS incluye Apache httpd, por lo que no es necesario instalarlo. Está deshabilitado por defecto.

Iniciar Apache¶

sudo apachectl start

Verificar la instalación¶

1. Abre tu navegador
2. Navega a http://localhost
3. Deberías ver el mensaje "It works!"

Obligatorio: habilitar mod_rewrite¶

El dashboard requiere reescritura de URL. Abre la configuración de Apache:

sudo nano /etc/apache2/httpd.conf

Encuentra la siguiente línea y elimina el # inicial para descomentarlo:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Obligatorio: permitir overrides con .htaccess¶

En el mismo archivo, localiza el bloque <Directory "/Library/WebServer/Documents"> y cambia:

AllowOverride None

por:

AllowOverride All

Obligatorio: tipo MIME para archivos Markdown¶

Aún en httpd.conf, añade la siguiente línea para que los archivos Markdown se sirvan correctamente:

AddType text/markdown .md

Aplicar la configuración¶

Comprueba la sintaxis de la configuración y luego reinicia Apache:

sudo apachectl configtest
sudo apachectl restart

Instalación inicial¶

Paso 1: Configurar el repositorio de digna¶

El repositorio de digna almacena todas las métricas calculadas por digna. Actúa como la base de datos central para datos analíticos y de rendimiento.

Crear esquema y usuario del repositorio¶

Abre tu cliente PostgreSQL (psql, pgAdmin u otro) y ejecuta las siguientes sentencias SQL:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Reemplaza los siguientes marcadores:

• <digna_repo_schema> — El nombre de esquema que desees (por ejemplo, dignarepo)
• <digna_repo_user> — El nombre de usuario que desees (por ejemplo, digna_user)
• <digna_repo_password> — Una contraseña segura para este usuario

Ejemplo:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Para ejecutar esto desde Terminal en un solo paso:

psql postgres

Luego pega las sentencias en el prompt postgres=# y escribe \q para salir.

Paso 2: Extraer el paquete de instalación de digna¶

1. Localiza el archivo ZIP de instalación de digna proporcionado
2. Extráelo en la ubicación de instalación deseada — por ejemplo /opt/digna o ~/digna
3. Tras la extracción, deberías ver los siguientes elementos:
4. dashboard/ — Interfaz web del dashboard
5. digna — Ejecutable principal (backend + CLI combinados)

Para extraer desde Terminal:

unzip digna-2026.11-macos.zip -d /opt/digna

Hacer el ejecutable ejecutable¶

Dependiendo de cómo se transfirió el archivo, el bit de ejecutable puede no conservarse tras la extracción. Establécelo explícitamente:

cd /opt/digna
chmod +x digna

Si macOS bloquea la aplicación¶

Los archivos descargados mediante un navegador o cliente de correo se marcan con un atributo de cuarentena. Si macOS informa que la app "cannot be opened because the developer cannot be verified", quita el atributo de cuarentena del directorio de instalación:

xattr -dr com.apple.quarantine /opt/digna

Alternativamente, abre System Settings → Privacy & Security, encuentra el elemento bloqueado cerca del final de la página y haz clic en Open Anyway.

Paso 3: Instalar el archivo de licencia¶

1. Localiza el archivo license.toml que se te proporcionó
2. Copia este archivo al directorio raíz de instalación de digna (donde están config.toml y el ejecutable digna)

Por qué importa: El archivo de licencia contiene la información de cliente, la fecha de expiración de la licencia y la firma digital. No modifiques este archivo — cualquier cambio lo invalidará.

Estructura de directorios después de la configuración:

/opt/digna/
├── config.toml         (archivo de configuración)
├── license.toml        (TU ARCHIVO DE LICENCIA - cópialo aquí)
├── digna               (ejecutable principal)
├── bin/                (scripts para gestión del servicio)
└── dashboard/          (interfaz web)
    └── (archivos del dashboard)

Configuración del backend¶

Paso 1: Crear y editar el archivo de configuración¶

El archivo config_template.toml se proporciona en el directorio de instalación de digna. Solo necesitas renombrarlo a config.toml.

cd /opt/digna
mv config_template.toml config.toml

Ubicación: /opt/digna/config.toml

Abre config.toml en un editor de texto y configura cada sección a continuación.

Sección [app]¶

Esta sección configura el intercambio de recursos entre orígenes (CORS) entre el dashboard y el backend:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

Sección [repo]¶

Esta sección configura la conexión a la base de datos PostgreSQL:

[repo]
DIGNA_REPO_HOST = "localhost"
DIGNA_REPO_PORT = 5432
DIGNA_REPO_DB = "postgres"
DIGNA_REPO_SCHEMA = "dignarepo"
DIGNA_REPO_USER = "digna_user"
DIGNA_REPO_PASSWORD = "YourSecurePassword123!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

Sección [base]¶

Esta sección contiene ajustes de seguridad, cookies e inspecciones:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

Sección [encryption]¶

Esta sección contiene la clave utilizada para cifrar los valores sensibles almacenados en el repositorio. Es obligatoria: config check informa de la sección [encryption] como FAILED si falta la clave.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Sección [logging]¶

Esta sección configura el comportamiento del registro (logging):

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

Sección [duckdb] (opcional)¶

Novedad de la Release 2026.11. Esta sección define los recursos del digna Engine, que perfila datos dentro de digna para las conexiones de base de datos cuya ubicación de perfilado es digna Engine, y ejecuta comprobaciones de integridad referencial entre fuentes de datos de distintas conexiones de base de datos. Consulta Ubicación de perfilado.

La sección es opcional. Sin ella, se aplican los valores por defecto que se indican a continuación.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

Paso 2: Validar la configuración¶

Antes de inicializar el repositorio, compruebe que config.toml está completo y bien formado. En su directorio de instalación de digna, ejecute:

./digna config check

Cada sección se valida por separado, de modo que un único error no oculta el estado del resto:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Corrija todo lo que se informe como FAILED y vuelva a ejecutar el comando antes de continuar. Un WARNING en Unknown keys enumera las claves de config.toml que digna no lee; no tienen ningún efecto, así que elimínelas o corrija su ortografía. La lista completa de opciones está en la referencia de la CLI.

Paso 3: Inicializar el repositorio¶

1. Abre Terminal
2. Navega al directorio de instalación de digna (donde están config.toml y el ejecutable digna)
3. Ejecuta la prueba de conexión:

cd /opt/digna
./digna repo check

En un esquema nuevo, el comando se conecta y después informa de que aún no hay ningún repositorio instalado:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

En este punto, ese es el resultado esperado: confirma que digna llega a PostgreSQL y al esquema. En cambio, un error de conexión o de autenticación apunta a la sección [repo] o a la configuración de PostgreSQL.

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

Paso 4: Instalar el esquema del repositorio¶

En el mismo directorio, ejecuta:

./digna repo upgrade

Este comando instala las tablas necesarias en el esquema del repositorio y termina con:

✅ Repo schema 'dignarepo' is up to date.

Paso 5: Crear un usuario administrador¶

1. Abre una ventana de Terminal nueva
2. Navega al directorio de instalación de digna
3. Ejecuta el siguiente comando para crear un usuario administrador:

./digna user add <email> <password> "<display_name>" --admin

Ejemplo:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

Esto crea un usuario con el correo electrónico admin@example.com y privilegios administrativos completos.

Paso 6: Iniciar el servidor digna¶

En el directorio de instalación de digna, inicia el servidor con:

./digna serve --address <host> --port <port>

Parámetros: - --address — Nombre de host/IP del servidor (por defecto 127.0.0.1) - --port — Puerto del servidor (por defecto 8000)

Cuando el servidor está en marcha, muestra la dirección en la que escucha:

Server running on http://127.0.0.1:8082

Configuración del dashboard¶

Paso 1: Desplegar el dashboard en el servidor web¶

El dashboard de digna lee su propia configuración de dashboard/dashboard_config.toml. Ese archivo no se incluye en la instalación: lo creas en el directorio dashboard/, junto a los archivos del dashboard.

Su contenido se describe en Inicio de sesión único, que es también donde se necesita el archivo: contiene las opciones de inicio de sesión que ofrece el dashboard y, para despliegues multi-instancia, la conexión al backend.

Elige tu servidor web y sigue los pasos de despliegue correspondientes.

Desplegar en nginx¶

Si seguiste la sección de Configuración de nginx, el bloque del servidor ya apunta a tu carpeta dashboard y no es necesario copiar nada.

1. Confirmar la ruta
2. Abre $(brew --prefix)/etc/nginx/servers/digna.conf

3. Verifica que root apunte a tu carpeta dashboard extraída

4. Asegurarse de que la carpeta sea legible

   chmod -R a+rX /opt/digna/dashboard
   

5. Recargar nginx

   nginx -t
   brew services restart nginx
   

6. Probar la instalación

7. Abre tu navegador
8. Navega a http://localhost:8080 (o a la URL configurada)
9. Deberías ver la página de inicio de sesión del dashboard de digna

Desplegar en Apache httpd¶

1. Copiar el dashboard al Document Root

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Añadir las reglas de reescritura

Crea un archivo .htaccess dentro de la carpeta desplegada para que las rutas del dashboard sobrevivan a una actualización del navegador:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Pega lo siguiente:

RewriteEngine On
RewriteBase /digna/

# Servir archivos y directorios existentes tal cual.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Todo lo demás vuelve al punto de entrada de la aplicación de una sola página.
RewriteRule ^ index.html [L]

1. Reiniciar Apache

   sudo apachectl restart
   

2. Acceder al dashboard

3. Abre tu navegador
4. Navega a http://localhost/digna
5. Deberías ver la página de inicio de sesión del dashboard de digna

Ejecutar digna como servicio en segundo plano¶

¿Por qué ejecutar digna como servicio?¶

Ejecutar el backend de digna como un servicio en segundo plano garantiza que:

• Se inicie automáticamente cuando la máquina arranque
• Se ejecute en segundo plano sin una ventana de Terminal abierta
• Se reinicie automáticamente si falla
• Puede gestionarse mediante launchctl, el gestor de servicios de macOS

Archivos de gestión del servicio¶

Todos los archivos necesarios se encuentran en el directorio de instalación de digna bajo: bin/

Los siguientes scripts shell están disponibles:

• install_service.sh — Registra digna con launchd
• uninstall_service.sh — Desregistra el servicio
• start_service.sh — Inicia el servicio registrado
• stop_service.sh — Detiene el servicio en ejecución

Hacer los scripts ejecutables¶

La extracción puede no preservar el bit ejecutable. Antes del primer uso:

cd /opt/digna/bin
chmod +x *.sh

Instalar el servicio¶

1. Abrir Terminal

2. Navegar a la carpeta bin

   cd /opt/digna/bin
   

3. Ejecutar el script de instalación

   sudo ./install_service.sh
   

El servidor digna ahora está registrado en launchd con el inicio automático habilitado. El servicio no se inicia inmediatamente — consulta la sección siguiente para iniciarlo.

Iniciar y detener el servicio¶

Para iniciar el servicio¶

1. Abre Terminal
2. Navega a /opt/digna/bin
3. Ejecuta:

   sudo ./start_service.sh
   

Para detener el servicio¶

1. Abre Terminal
2. Navega a /opt/digna/bin
3. Ejecuta:

   sudo ./stop_service.sh
   

Verificar el servicio¶

Para confirmar que el servicio está registrado y en ejecución:

sudo launchctl list | grep digna

Una línea que comience con un ID de proceso indica que el servicio está en ejecución. Un - en la primera columna significa que está registrado pero detenido.

Mover el servicio a un nuevo directorio¶

launchd almacena la ruta absoluta al ejecutable, por lo que mover la instalación requiere volver a registrar el servicio:

1. Desinstalar el servicio actual

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Mover los archivos de la aplicación

   sudo mv /old/path/digna /new/path/digna
   

3. Reinstalar el servicio

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Iniciar el servicio

   sudo ./start_service.sh
   

Desinstalar el servicio¶

1. Detener el servicio en ejecución

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Desinstalar el servicio

   sudo ./uninstall_service.sh
   

El servidor digna ya no estará registrado en launchd.

Actualizar a una nueva versión¶

Esta sección actualiza una instalación de la Release 2026.06 a la Release 2026.11. Si tu instalación es más antigua, lee primero Actualizar desde una versión anterior a la 2026.06.

Antes de actualizar¶

Es obligatorio crear una copia de seguridad del repositorio de digna

Antes de actualizar digna, realiza una copia de seguridad de tu repositorio (PostgreSQL) para protegerte contra pérdida de datos. Una copia de seguridad asegura que puedas recuperar los datos si la actualización encuentra problemas inesperados.

Para crear una copia de seguridad desde Terminal:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Solicitar el archivo de licencia para la Release 2026.11

La Release 2026.11 necesita un nuevo license.toml. Solicítalo al equipo de digna antes de empezar y tenlo preparado para el paso 7.

Actualizar desde una versión anterior a la 2026.06¶

La Release 2026.06 introdujo tres cambios que siguen aplicándose cuando actualizas una instalación más antigua directamente a la 2026.11:

• Solo ODBC. digna accede a cada tecnología de origen mediante ODBC. Toda conexión de base de datos que aún no use ODBC debe cambiarse a ODBC después de la actualización; no hay conversión automática. Instala de antemano los controladores ODBC en el host de digna (consulta Instalar el controlador ODBC en el host de digna) y ten preparadas las propiedades de cada conexión a partir de las guías por tecnología. El conector Databricks Legacy ya no existe; traslada esas conexiones al conector Databricks.
• Un único ejecutable. dignabackend y dignacli se sustituyen por el ejecutable único digna, que combina el backend y la CLI.
• config.toml. La sección [encryption] es obligatoria, y DIGNA_APP_HOST y DIGNA_APP_PORT ya no se leen: el servidor toma su dirección y su puerto de digna serve. Compara tu archivo con Configuración del backend.

Los pasos siguientes indican dónde una instalación más antigua necesita algo distinto. La actualización del repositorio del paso 8 lleva un repositorio de cualquier versión anterior directamente a la 2026.11.

Proceso de actualización¶

Paso 1: Detener el servicio digna¶

Si digna se está ejecutando como servicio en segundo plano, deténlo primero:

cd /opt/digna/bin
sudo ./stop_service.sh

Si digna se ejecuta en primer plano, presiona Ctrl+C en la ventana de Terminal donde se esté ejecutando.

Paso 2: Respaldar la instalación actual¶

En tu directorio de instalación de digna, cambia el nombre del ejecutable y de la carpeta del dashboard de tu instalación actual, para que la nueva versión pueda desplegarse junto a ellos:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Conserva digna_old hasta que hayas verificado la actualización, y dashboard_old hasta que hayas restaurado desde ella tus archivos de configuración (consulta el paso 4). Después puedes eliminar ambos.

Paso 3: Extraer y desplegar la nueva versión¶

1. Extrae el nuevo archivo ZIP de instalación de digna
2. Copia el nuevo ejecutable digna y la carpeta dashboard a tu directorio de instalación
3. Restaura el bit de ejecutable y, si es necesario, quita el atributo de cuarentena:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Paso 4: Restaurar tus archivos de configuración¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

La Release 2026.11 no requiere ningún cambio en config.toml: un archivo que funciona con la Release 2026.06 sigue funcionando. Hay dos cambios opcionales:

• Añade una sección [duckdb] si las conexiones de base de datos van a usar el digna Engine y sus valores por defecto no se ajustan a tu host.
• Omite la sección [app] si un proxy inverso sirve el dashboard y el backend bajo un mismo origen.

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

Paso 5: Recargar el servidor web¶

El dashboard es un conjunto de archivos estáticos, por lo que tu servidor web —y el navegador— pueden seguir sirviendo la versión anterior. Recarga o reinicia el servidor web que aloje la carpeta dashboard y, a continuación, recarga la página forzando la actualización (Cmd+Shift+R).

Paso 6: Validar la configuración¶

Confirma que config.toml está completo antes de tocar el repositorio:

./digna config check

Todas las secciones deben informar OK. Corrige todo lo que se informe como FAILED, elimina las claves enumeradas en Unknown keys y vuelve a ejecutar el comando antes de continuar.

Paso 7: Sustituir el archivo de licencia¶

Normalmente, un archivo de licencia sigue sirviendo de una versión a la siguiente. La Release 2026.11 es una excepción: añade dos módulos con licencia, digna Data Reconciliation y digna Agentic, y una licencia emitida antes de la 2026.11 no los contiene. Copia el license.toml que el equipo de digna te proporcionó para la Release 2026.11 en el directorio de instalación, sustituyendo el anterior:

cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Paso 8: Actualizar el esquema del repositorio¶

En tu directorio de instalación de digna, ejecuta:

cd /opt/digna
./digna repo upgrade

La Release 2026.11 gestiona el esquema del repositorio con migraciones versionadas. La primera actualización desde una versión anterior lleva el esquema a la última versión del sistema anterior, registra ese estado como punto de partida y, a continuación, aplica las migraciones de la Release 2026.11. Termina con:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Se conservan todos los datos existentes. Para ver el estado del repositorio en cualquier momento, ejecuta ./digna repo check: muestra la última migración aplicada y las que estén pendientes.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

Paso 9: Reiniciar servicios¶

Si se ejecuta como servicio en segundo plano:

cd /opt/digna/bin
sudo ./start_service.sh

Si se ejecuta manualmente, reinicia el servidor:

cd /opt/digna
./digna serve --address <address> --port <port>

Si usas nginx o Apache, reinicia el servidor web correspondiente:

brew services restart nginx

sudo apachectl restart

Paso 10: Verificar la actualización¶

1. Confirma la versión del nuevo ejecutable:

   ./digna version
   

   La primera línea debe ser Release: 2026.11.

2. Accede al dashboard de digna y verifica que la interfaz carga correctamente.

3. Revisa la salida del servidor y los archivos del directorio logs por si hay errores.
4. Prueba tus conexiones de base de datos: consulta Probar una conexión. Tras una actualización desde una versión anterior a la 2026.06, convierte primero a ODBC todas las conexiones que aún no lo usaran.

Para empezar con los nuevos módulos, consulta digna Data Reconciliation, Conectar un agente de IA para el digna MCP Server y Ubicación de perfilado para el digna Engine.