Guia de Instalação no macOS para o digna Release 2026.11¶

Release: 2026.11

Última Atualização: 7 de novembro de 2026

Sumário¶

1. Introdução
2. Requisitos do Sistema
3. Pré-instalação
4. Configuração do Servidor PostgreSQL
5. Configuração do Servidor Web
6. Instalação Inicial
7. Configuração do Backend
8. Configuração do Dashboard
9. Executando o digna como um Serviço em Segundo Plano
10. Atualizando para uma Nova Release

Introdução¶

Sobre o digna¶

digna é uma plataforma abrangente guiada por IA, projetada para otimizar o gerenciamento da qualidade de dados em diversos ambientes de dados, como data warehouses, data lakes e lakehouses. Desenvolvida para ser altamente escalável e adaptável, digna resolve desafios modernos de dados por meio de automação, monitoramento em tempo real e detecção de anomalias.

O digna consiste em dois componentes principais:

• digna: o núcleo da aplicação, responsável por processar os dados e executar as verificações de qualidade. Reúne o backend e a interface de linha de comando em um único executável, substituindo os programas separados dignabackend e dignacli das versões anteriores.
• dignadashboard: Uma interface web hospedada em um servidor web, que fornece uma forma amigável de interagir com a plataforma digna e visualizar métricas de qualidade de dados.

Novidades no Release 2026.11¶

Esta release adiciona o digna Data Reconciliation, o digna Agentic com o digna MCP Server e o digna Engine, que pode fazer o profiling dos dados dentro do digna e verificar a integridade referencial entre diferentes tecnologias de banco de dados. Consulte as notas de versão para detalhes completos.

Para uma instalação, a release traz um novo mecanismo de migração do repositório, uma seção [duckdb] opcional no config.toml para o digna Engine e um novo arquivo de licença. A seção de atualização aborda cada um deles.

Procurando Windows ou Linux?¶

Este guia cobre o macOS. Para outras plataformas, veja o Windows Installation Guide ou o Linux Installation Guide.

Requisitos do Sistema¶

Antes de iniciar a instalação, verifique se seu sistema atende aos seguintes requisitos mínimos:

Opções de Instalação do Banco de Dados¶

Se o PostgreSQL já estiver instalado: Você pode adicionar um novo banco de dados para o digna ao seu servidor PostgreSQL existente.

Se for instalar o PostgreSQL na mesma máquina que o digna:

Verificando Sua Arquitetura¶

Vários caminhos neste guia diferem entre Macs Apple Silicon e Intel. Para verificar qual você possui, abra o Terminal e execute:

uname -m

• arm64 — Apple Silicon. O Homebrew instala em /opt/homebrew.
• x86_64 — Intel. O Homebrew instala em /usr/local.

Pré-instalação¶

Antes de instalar o digna, certifique-se de que três pré-requisitos principais estejam em vigor:

1. Homebrew – o gerenciador de pacotes utilizado para instalar os componentes abaixo
2. PostgreSQL Server – para armazenar métricas calculadas e dados de desempenho
3. Servidor Web – para hospedar o digna Dashboard

Se esses componentes ainda não estiverem configurados, siga as seções abaixo para instalá-los e configurá-los.

Instalando o Homebrew¶

O Homebrew é o gerenciador de pacotes padrão para macOS e é usado ao longo deste guia para instalar PostgreSQL e nginx.

Passo 1: Verificar se o Homebrew já está instalado¶

Abra o Terminal (pressione Cmd + Space, digite Terminal, pressione Enter) e execute:

brew --version

Se um número de versão for retornado, pule para a seção Configuração do Servidor PostgreSQL.

Passo 2: Instalar o Homebrew¶

Se o comando não for encontrado, instale o Homebrew seguindo as instruções no site oficial do Homebrew. O instalador também instala as Xcode Command Line Tools se elas não estiverem presentes.

Passo 3: Adicionar o Homebrew ao seu PATH¶

No Apple Silicon, o instalador imprime dois comandos para adicionar o Homebrew ao seu ambiente de shell. Execute-os conforme instruído e depois confirme:

brew --prefix

Isto deve imprimir /opt/homebrew no Apple Silicon ou /usr/local no Intel.

Configuração do Servidor PostgreSQL¶

Se Você Já Tem PostgreSQL¶

Se o PostgreSQL já estiver instalado e em execução na sua máquina local ou se você estiver usando um servidor PostgreSQL gerenciado remoto, você pode pular para a próxima seção.

Opções de Instalação¶

O macOS oferece duas maneiras simples de instalar o PostgreSQL. Escolha uma:

• Homebrew — instalação via linha de comando, recomendada para implantações de servidor
• Postgres.app — instalação gráfica, conveniente para avaliação local

Instalando PostgreSQL com Homebrew¶

Passo 1: Instalar a fórmula do PostgreSQL¶

brew install postgresql@16

Passo 2: Adicionar o PostgreSQL ao seu PATH¶

As fórmulas versionadas do PostgreSQL são keg-only, o que significa que o Homebrew não vincula seus comandos ao seu PATH automaticamente. Adicione-os você mesmo:

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

Passo 3: Iniciar o serviço PostgreSQL¶

brew services start postgresql@16

Isto inicia o PostgreSQL imediatamente e o configura para iniciar automaticamente quando você efetuar login.

Passo 4: Verificar a instalação¶

psql --version

Você deverá ver a versão do PostgreSQL se a instalação foi bem-sucedida.

Passo 5: Conectar-se ao servidor¶

psql postgres

Passo 6: Confirmar a porta¶

A porta padrão do PostgreSQL é 5432. Para confirmar a porta em que seu servidor está escutando:

psql postgres -c "SHOW port;"

Anote o valor — você precisará dele ao configurar o backend do digna.

Instalando PostgreSQL com Postgres.app¶

Se preferir uma instalação gráfica:

1. Baixe o Postgres.app e arraste-o para a sua pasta Applications
2. Abra o app e clique em Initialize para criar um novo servidor
3. Siga as instruções do app para adicionar suas ferramentas de linha de comando ao PATH
4. Verifique a instalação:

psql --version

O Postgres.app também cria um superusuário com o nome da sua conta macOS.

Configuração do Servidor Web¶

O digna requer um servidor web para hospedar o dashboard. Escolha uma das seguintes opções:

• nginx — instalado via Homebrew, recomendado
• Apache httpd — incluído no macOS

Você só precisa instalar e configurar um desses servidores.

Ambas as seções configuram duas coisas das quais o dashboard depende:

• Fallback para single-page application, para que atualizar a URL do dashboard no navegador não retorne 404
• Um tipo MIME para .md, para que arquivos Markdown sejam servidos corretamente

Configuração do nginx¶

Visão Geral¶

O nginx é um servidor web leve e de alto desempenho, adequado para servir o dashboard estático do digna.

Instalação¶

brew install nginx

Iniciando o nginx¶

brew services start nginx

Verificar a Instalação¶

1. Abra seu navegador
2. Navegue para http://localhost:8080
3. Você deverá ver a página de boas-vindas do nginx

Configurando um Site para o Dashboard¶

A configuração do nginx do Homebrew inclui todos os arquivos do diretório servers. Crie um arquivo de configuração dedicado para o digna lá:

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

Cole o seguinte, substituindo /path/to/digna/dashboard pelo caminho real da sua pasta dashboard extraída:

server {
    listen       8080;
    server_name  localhost;

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

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Aplicar a Configuração¶

Teste a configuração para erros de sintaxe e então recarregue o nginx:

nginx -t
brew services restart nginx

Configuração do Apache httpd¶

Visão Geral¶

O macOS inclui o Apache httpd, portanto não é necessária instalação. Ele vem desativado por padrão.

Iniciando o Apache¶

sudo apachectl start

Verificar a Instalação¶

1. Abra seu navegador
2. Navegue para http://localhost
3. Você deverá ver a mensagem "It works!"

Obrigatório: Habilitar mod_rewrite¶

O dashboard requer reescrita de URL. Abra a configuração do Apache:

sudo nano /etc/apache2/httpd.conf

Encontre a seguinte linha e remova o # inicial para descomentá-la:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Obrigatório: Permitir Overrides via .htaccess¶

No mesmo arquivo, localize o bloco <Directory "/Library/WebServer/Documents"> e altere:

AllowOverride None

para:

AllowOverride All

Obrigatório: Tipo MIME para Arquivos Markdown¶

Ainda em httpd.conf, adicione a linha a seguir para que arquivos Markdown sejam servidos corretamente:

AddType text/markdown .md

Aplicar a Configuração¶

Verifique a configuração por erros de sintaxe e então reinicie o Apache:

sudo apachectl configtest
sudo apachectl restart

Instalação Inicial¶

Passo 1: Configure o Repositório do digna¶

O repositório do digna armazena todas as métricas calculadas pelo digna. Ele atua como o banco de dados central para dados analíticos e de desempenho.

Criar Esquema e Usuário do Repositório¶

Abra seu cliente PostgreSQL (psql, pgAdmin ou similar) e execute os seguintes comandos 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>;

Substitua os seguintes placeholders:

• <digna_repo_schema> — O nome do schema desejado (por exemplo, dignarepo)
• <digna_repo_user> — O nome de usuário desejado (por exemplo, digna_user)
• <digna_repo_password> — Uma senha segura para este usuário

Exemplo:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Para executar isso a partir do Terminal em um único passo:

psql postgres

Em seguida cole as instruções no prompt postgres=# e digite \q para sair.

Passo 2: Extraia o Pacote de Instalação do digna¶

1. Localize o arquivo ZIP de instalação do digna fornecido a você
2. Extraia-o para o local de instalação desejado — por exemplo /opt/digna ou ~/digna
3. Após a extração, você deverá ver os seguintes itens:
4. dashboard/ — Interface web do dashboard
5. digna — Executável principal (backend + CLI combinados)

Para extrair pelo Terminal:

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

Tornar o Executável Executável¶

Dependendo de como o arquivo foi transferido, o bit de execução pode não sobreviver à extração. Defina-o explicitamente:

cd /opt/digna
chmod +x digna

Se o macOS Bloquear a Aplicação¶

Arquivos baixados via navegador ou cliente de e-mail são marcados com um atributo de quarentena. Se o macOS relatar que o app "cannot be opened because the developer cannot be verified", remova o atributo da pasta de instalação:

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

Alternativamente, abra System Settings → Privacy & Security, encontre o item bloqueado próximo ao final da página e clique em Open Anyway.

Passo 3: Instalar o Arquivo de Licença¶

1. Localize o arquivo license.toml fornecido a você
2. Copie-o para o diretório raiz de instalação do digna (onde estão config.toml e o executável digna)

Por que isso é importante: O arquivo de licença contém suas informações de cliente, data de expiração da licença e assinatura digital. Não modifique este arquivo — quaisquer alterações o invalidarão.

Estrutura de diretórios após a configuração:

/opt/digna/
├── config.toml         (arquivo de configuração)
├── license.toml        (SEU ARQUIVO DE LICENÇA - copie aqui)
├── digna               (executável principal)
├── bin/                (scripts de gerenciamento do serviço)
└── dashboard/          (interface web)
    └── (arquivos do dashboard)

Configuração do Backend¶

Passo 1: Criar e Editar o Arquivo de Configuração¶

O arquivo config_template.toml é fornecido no diretório de instalação do digna. Você só precisa renomeá-lo para config.toml.

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

Localização: /opt/digna/config.toml

Abra config.toml em um editor de texto e configure cada seção abaixo.

Seção [app]¶

Esta seção configura o compartilhamento de recursos entre origens (CORS) entre o dashboard e o backend:

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

Seção [repo]¶

Esta seção configura a conexão com o banco de dados 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

Seção [base]¶

Esta seção contém configurações de segurança, cookies e inspeção:

[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

Seção [encryption]¶

Esta seção contém a chave usada para criptografar os valores sensíveis armazenados no repositório. Ela é obrigatória — config check informa a seção [encryption] como FAILED se a chave estiver ausente.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Seção [logging]¶

Esta seção configura o comportamento de logging:

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

Seção [duckdb] (Opcional)¶

Novidade da Release 2026.11. Esta seção define os recursos do digna Engine, que faz o profiling dos dados dentro do digna para as conexões de banco de dados cujo local de profiling é digna Engine, e executa verificações de integridade referencial entre fontes de dados em conexões de banco de dados diferentes. Consulte Profiling Location.

A seção é opcional. Sem ela, valem os padrões abaixo.

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

mkdir -p /opt/digna/tmp

Passo 2: Validar a Configuração¶

Antes de inicializar o repositório, verifique se o config.toml está completo e bem formado. No diretório de instalação do digna, execute:

./digna config check

Cada seção é validada separadamente, de modo que um único erro não esconde o estado das demais:

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 tudo o que for informado como FAILED e execute o comando novamente antes de continuar. Um WARNING em Unknown keys lista chaves do config.toml que o digna não lê; elas não têm efeito, então remova-as ou corrija a grafia. A lista completa de opções está na referência da CLI.

Passo 3: Inicializar o Repositório¶

1. Abra o Terminal
2. Navegue até o diretório de instalação do digna (onde config.toml e o executável digna estão localizados)
3. Execute o teste de conexão:

cd /opt/digna
./digna repo check

Em um schema novo, o comando se conecta e então informa que ainda não há nenhum repositório instalado:

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

Neste ponto, esse é o resultado esperado: ele confirma que o digna alcança o PostgreSQL e o schema. Já um erro de conexão ou de autenticação aponta para a seção [repo] ou para a configuração do PostgreSQL.

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

Passo 4: Instalar o Schema do Repositório¶

No mesmo diretório, execute:

./digna repo upgrade

Este comando instala as tabelas necessárias no schema do repositório e termina com:

✅ Repo schema 'dignarepo' is up to date.

Passo 5: Criar um Usuário Admin¶

1. Abra uma nova janela do Terminal
2. Navegue até o diretório de instalação do digna
3. Execute o seguinte comando para criar um usuário admin:

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

Exemplo:

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

Isto cria um utilizador com o endereço de e-mail admin@example.com e privilégios administrativos completos.

Passo 6: Iniciar o Servidor digna¶

No diretório de instalação do digna, inicie o servidor com:

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

Parâmetros: - --address — Hostname/IP do servidor (padrão 127.0.0.1) - --port — Porta do servidor (padrão 8000)

Quando o servidor estiver no ar, ele exibe o endereço em que está escutando:

Server running on http://127.0.0.1:8082

Configuração do Dashboard¶

Passo 1: Fazer o Deploy do Dashboard no Servidor Web¶

O dashboard do digna lê sua própria configuração do arquivo dashboard/dashboard_config.toml. Esse arquivo não acompanha a instalação — você o cria no diretório dashboard/, junto com os arquivos do dashboard.

O conteúdo dele está descrito em Single Sign-On, que é também onde o arquivo é necessário: ele contém as opções de login que o dashboard oferece e, em implantações com múltiplas instâncias, a conexão com o backend.

Escolha seu servidor web e siga as etapas de implantação correspondentes.

Implantando no nginx¶

Se você seguiu a seção de Configuração do nginx, o server block já aponta para sua pasta dashboard e nenhuma cópia é necessária.

1. Confirme o caminho
2. Abra $(brew --prefix)/etc/nginx/servers/digna.conf

3. Verifique se root aponta para a sua pasta dashboard extraída

4. Garanta que a pasta seja legível

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

5. Recarregue o nginx

   nginx -t
   brew services restart nginx
   

6. Teste a Instalação

7. Abra seu navegador
8. Navegue para http://localhost:8080 (ou sua URL configurada)
9. Você deverá ver a página de login do digna dashboard

Implantando no Apache httpd¶

1. Copie o Dashboard para o Document Root

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

2. Adicione as Regras de Rewrite

Crie um arquivo .htaccess dentro da pasta implantada para que as rotas do dashboard sobrevivam a um refresh do navegador:

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

Cole o seguinte:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Reinicie o Apache

   sudo apachectl restart
   

2. Acesse o Dashboard

3. Abra seu navegador
4. Navegue para http://localhost/digna
5. Você deverá ver a página de login do digna dashboard

Executando o digna como um Serviço em Segundo Plano¶

Por que executar o digna como um serviço?¶

Executar o backend do digna como serviço em segundo plano garante que ele:

• Inicie automaticamente quando a máquina for ligada
• Execute em segundo plano sem uma janela do Terminal aberta
• Reinicie automaticamente se travar
• Possa ser gerenciado através do launchctl, o gerenciador de serviços do macOS

Arquivos de Gerenciamento do Serviço¶

Todos os arquivos necessários estão localizados no diretório de instalação do digna em: bin/

Os seguintes scripts shell estão disponíveis:

• install_service.sh — Registra o digna no launchd
• uninstall_service.sh — Remove o registro do serviço
• start_service.sh — Inicia o serviço registrado
• stop_service.sh — Para o serviço em execução

Tornando os Scripts Executáveis¶

A extração pode não preservar o bit executável. Antes do primeiro uso:

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

Instalando o Serviço¶

1. Abra o Terminal

2. Navegue até a pasta bin

   cd /opt/digna/bin
   

3. Execute o script de instalação

   sudo ./install_service.sh
   

O servidor digna agora está registrado no launchd com inicialização automática habilitada. O serviço não inicia imediatamente — veja a seção a seguir para iniciá-lo.

Iniciando e Parando o Serviço¶

Para Iniciar o Serviço¶

1. Abra o Terminal
2. Navegue para /opt/digna/bin
3. Execute:

   sudo ./start_service.sh
   

Para Parar o Serviço¶

1. Abra o Terminal
2. Navegue para /opt/digna/bin
3. Execute:

   sudo ./stop_service.sh
   

Verificando o Serviço¶

Para confirmar que o serviço está registrado e em execução:

sudo launchctl list | grep digna

Uma linha começando com um ID de processo indica que o serviço está em execução. Um - na primeira coluna significa que está registrado mas parado.

Movendo o Serviço para um Novo Diretório¶

O launchd armazena o caminho absoluto para o executável, portanto mover a instalação exige re-registrar o serviço:

1. Desinstalar o serviço atual

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

2. Mover os arquivos da aplicação

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

3. Reinstalar o serviço

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

4. Iniciar o serviço

   sudo ./start_service.sh
   

Desinstalando o Serviço¶

1. Parar o serviço em execução

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

2. Desinstalar o serviço

   sudo ./uninstall_service.sh
   

O servidor digna agora está desregistrado do launchd.

Atualizando para uma Nova Release¶

Esta seção atualiza uma instalação da Release 2026.06 para a Release 2026.11. Se a sua instalação for mais antiga, leia primeiro Atualizando a Partir de uma Release Anterior à 2026.06.

Antes de Atualizar¶

É Obrigatório Criar um Backup do Repositório do digna

Antes de atualizar o digna, faça backup do seu repositório (PostgreSQL) para proteger contra perda de dados. Um backup garante que você possa recuperar caso a atualização encontre problemas inesperados.

Para criar um backup a partir do Terminal:

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

Solicitando o Arquivo de Licença para a Release 2026.11

A Release 2026.11 precisa de um novo license.toml. Solicite-o à equipe do digna antes de começar e deixe-o pronto para o Passo 7.

Atualizando a Partir de uma Release Anterior à 2026.06¶

A Release 2026.06 trouxe três mudanças que continuam valendo quando você atualiza uma instalação mais antiga diretamente para a 2026.11:

• Somente ODBC. O digna acessa cada tecnologia de origem por ODBC. Toda conexão de banco de dados que ainda não usa ODBC precisa ser convertida para ODBC após a atualização; não há conversão automática. Instale antes os drivers ODBC no host do digna, consulte Instalar o Driver ODBC no Host do digna, e tenha prontas as propriedades de cada conexão a partir dos guias por tecnologia. O conector Databricks Legacy não existe mais; mova essas conexões para o conector Databricks.
• Um único executável. dignabackend e dignacli são substituídos pelo executável único digna, que reúne o backend e a CLI.
• config.toml. A seção [encryption] é obrigatória, e DIGNA_APP_HOST e DIGNA_APP_PORT não são mais lidos: o servidor obtém seu endereço e sua porta de digna serve. Compare seu arquivo com a Configuração do Backend.

Os passos abaixo indicam onde uma instalação mais antiga precisa de algo diferente. A atualização do repositório no Passo 8 leva um repositório de qualquer release anterior diretamente para a 2026.11.

Processo de Atualização¶

Passo 1: Parar o Serviço digna¶

Se o digna estiver em execução como serviço em segundo plano, pare-o primeiro:

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

Se o digna estiver em execução em primeiro plano, pressione Ctrl+C na janela do Terminal onde ele está rodando.

Passo 2: Fazer Backup da Instalação Atual¶

No diretório de instalação do digna, renomeie o executável e a pasta do dashboard da sua instalação atual, para que a nova release possa ser implantada ao lado deles:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Mantenha digna_old até verificar a atualização, e dashboard_old até restaurar dele os seus arquivos de configuração (veja o Passo 4). Depois, você pode excluir ambos.

Passo 3: Extrair e Implantar a Nova Versão¶

1. Extraia o novo arquivo ZIP de instalação do digna
2. Copie o novo executável digna e a pasta dashboard para seu diretório de instalação
3. Restaure o bit de execução e, se necessário, limpe o atributo de quarentena:

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

Passo 4: Restaurar Seus Arquivos de Configuração¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

A Release 2026.11 não exige nenhuma alteração no config.toml: um arquivo que funciona com a Release 2026.06 continua funcionando. Duas alterações são opcionais:

• Adicione uma seção [duckdb] se as conexões de banco de dados forem usar o digna Engine e os padrões dele não forem adequados ao seu host.
• Omita a seção [app] se um proxy reverso servir o dashboard e o backend sob uma única origem.

[[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'

Passo 5: Recarregar o Servidor Web¶

O dashboard é um conjunto de arquivos estáticos, então seu servidor web — e o navegador — podem ainda estar servindo a versão anterior. Recarregue ou reinicie o servidor web que hospeda a pasta dashboard e, em seguida, recarregue a página com uma atualização forçada (Cmd+Shift+R).

Passo 6: Validar a Configuração¶

Confirme que o config.toml está completo antes de mexer no repositório:

./digna config check

Todas as seções devem informar OK. Corrija tudo o que for informado como FAILED, remova as chaves listadas em Unknown keys e execute o comando novamente antes de continuar.

Passo 7: Substituir o Arquivo de Licença¶

Normalmente, um arquivo de licença continua valendo de uma release para a seguinte. A Release 2026.11 é uma exceção: ela adiciona dois módulos licenciados, o digna Data Reconciliation e o digna Agentic, e uma licença emitida antes da 2026.11 não os contém. Copie o license.toml que a equipe do digna forneceu para a Release 2026.11 para o diretório de instalação, substituindo o antigo:

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

./digna license check

Passo 8: Atualizar o Schema do Repositório¶

No diretório de instalação do digna, execute:

cd /opt/digna
./digna repo upgrade

A Release 2026.11 gerencia o schema do repositório com migrações versionadas. A primeira atualização a partir de uma release anterior leva o schema à última versão do mecanismo anterior, registra isso como ponto de partida e, em seguida, aplica as migrações da Release 2026.11. Ela termina com:

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

Todos os dados existentes são preservados. Para ver o estado do repositório a qualquer momento, execute ./digna repo check: ele lista a última migração aplicada e as migrações pendentes.

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

Passo 9: Reiniciar Serviços¶

Se estiver rodando como serviço em segundo plano:

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

Se estiver executando manualmente, reinicie o servidor:

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

Se estiver usando nginx ou Apache, reinicie o respectivo servidor web:

brew services restart nginx

sudo apachectl restart

Passo 10: Verificar a Atualização¶

1. Confirme a release do novo executável:

   ./digna version
   

   A primeira linha deve ser Release: 2026.11.

2. Acesse o digna dashboard e verifique se a interface carrega corretamente.

3. Verifique a saída do servidor e os arquivos no diretório logs em busca de erros.
4. Teste suas conexões de banco de dados — consulte Testar uma Conexão. Após uma atualização a partir de uma release anterior à 2026.06, converta primeiro para ODBC todas as conexões que ainda não o usavam.

Para começar a usar os novos módulos, consulte digna Data Reconciliation, Conectar um Agente de IA para o digna MCP Server e Profiling Location para o digna Engine.