Посібник зі встановлення digna Release 2026.11 на macOS¶

Випуск: 2026.11

Останнє оновлення: 7 листопада 2026 р.

Зміст¶

1. Вступ
2. Системні вимоги
3. Підготовка до встановлення
4. Налаштування сервера PostgreSQL
5. Налаштування веб‑сервера
6. Початкове встановлення
7. Налаштування серверної частини
8. Налаштування панелі
9. Запуск digna як фонової служби
10. Оновлення до нового випуску

Вступ¶

Про digna¶

digna — це комплексна платформа на основі AI, призначена для оптимізації управління якістю даних у різних середовищах даних, таких як сховища даних (warehouses), озера даних (lakes) і lakehouses. Побудована з розрахунком на високу масштабованість та адаптивність, digna вирішує сучасні завдання роботи з даними завдяки автоматизації, моніторингу в реальному часі та виявленню аномалій.

digna складається з двох основних компонентів:

• digna: ядро застосунку, відповідальне за обробку даних і виконання перевірок якості. Воно поєднує серверну частину та інтерфейс командного рядка в одному виконуваному файлі, замінюючи окремі програми dignabackend і dignacli з попередніх випусків.
• dignadashboard: веб‑інтерфейс, розміщений на веб‑сервері, що забезпечує зручний спосіб взаємодії з платформою digna та візуалізації метрик якості даних.

Що нового в Release 2026.11¶

Цей випуск додає digna Data Reconciliation, digna Agentic із digna MCP Server, а також digna Engine, який може профілювати дані всередині digna та перевіряти референтну цілісність між різними технологіями баз даних. Повні відомості див. у примітках до випуску.

Для встановлення випуск приносить новий механізм міграції репозиторію, необов'язковий розділ [duckdb] у config.toml для digna Engine і новий файл ліцензії. Кожну з цих змін описано в розділі про оновлення.

Шукаєте Windows або Linux?¶

Цей посібник охоплює macOS. Для інших платформ див. Посібник зі встановлення на Windows або Посібник зі встановлення на Linux.

Системні вимоги¶

Перш ніж почати встановлення, переконайтеся, що ваша система відповідає таким мінімальним вимогам:

Варіанти встановлення бази даних¶

Якщо PostgreSQL уже встановлено: Ви можете додати нову базу даних для digna до наявного сервера PostgreSQL.

Якщо PostgreSQL встановлюється на тій самій машині, що й digna:

Перевірка архітектури¶

Кілька шляхів у цьому посібнику відрізняються для Mac з Apple Silicon і з Intel. Щоб перевірити, який у вас, відкрийте Terminal і виконайте:

uname -m

• arm64 — Apple Silicon. Homebrew встановлюється до /opt/homebrew.
• x86_64 — Intel. Homebrew встановлюється до /usr/local.

Підготовка до встановлення¶

Перед встановленням digna переконайтеся, що наявні три ключові передумови:

1. Homebrew – менеджер пакетів, яким установлюються наведені нижче компоненти
2. Сервер PostgreSQL – для зберігання обчислених метрик і даних про продуктивність
3. Веб‑сервер – для розміщення панелі digna (digna Dashboard)

Якщо ці компоненти ще не налаштовано, скористайтеся наведеними нижче розділами, щоб установити та налаштувати їх.

Встановлення Homebrew¶

Homebrew — стандартний менеджер пакетів для macOS, який у всьому цьому посібнику використовується для встановлення PostgreSQL і nginx.

Крок 1: Перевірте, чи Homebrew уже встановлено¶

Відкрийте Terminal (натисніть Cmd + Space, введіть Terminal, натисніть Enter) і виконайте:

brew --version

Якщо повертається номер версії, перейдіть до розділу Налаштування сервера PostgreSQL.

Крок 2: Встановіть Homebrew¶

Якщо команду не знайдено, установіть Homebrew за інструкціями на офіційному сайті Homebrew. Інсталятор також установлює Xcode Command Line Tools, якщо їх ще немає.

Крок 3: Додайте Homebrew до PATH¶

На Apple Silicon інсталятор виводить дві команди для додавання Homebrew до середовища вашої оболонки. Виконайте їх, як зазначено, а потім перевірте:

brew --prefix

Команда має вивести /opt/homebrew на Apple Silicon або /usr/local на Intel.

Налаштування сервера PostgreSQL¶

Якщо у вас уже є PostgreSQL¶

Якщо PostgreSQL уже встановлено й запущено на вашій локальній машині або ви використовуєте керований віддалений сервер PostgreSQL, можете перейти до наступного розділу.

Варіанти встановлення¶

macOS пропонує два простих способи встановити PostgreSQL. Виберіть один:

• Homebrew — встановлення з командного рядка, рекомендоване для серверних розгортань
• Postgres.app — графічне встановлення, зручне для локального ознайомлення

Встановлення PostgreSQL за допомогою Homebrew¶

Крок 1: Встановіть формулу PostgreSQL¶

brew install postgresql@16

Крок 2: Додайте PostgreSQL до PATH¶

Формули PostgreSQL із версією є keg-only, тобто Homebrew не додає їхні команди до PATH автоматично. Додайте їх самостійно:

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

Крок 3: Запустіть службу PostgreSQL¶

brew services start postgresql@16

Ця команда одразу запускає PostgreSQL і налаштовує його автоматичний запуск під час вашого входу в систему.

Крок 4: Перевірте встановлення¶

psql --version

Якщо встановлення пройшло успішно, ви побачите версію PostgreSQL.

Крок 5: Підключіться до сервера¶

psql postgres

Крок 6: Перевірте порт¶

Стандартний порт PostgreSQL — 5432. Щоб перевірити, який порт прослуховує ваш сервер:

psql postgres -c "SHOW port;"

Запишіть це значення — воно знадобиться під час налаштування серверної частини digna.

Встановлення PostgreSQL за допомогою Postgres.app¶

Якщо ви віддаєте перевагу графічному встановленню:

1. Завантажте Postgres.app і перетягніть його до теки Applications
2. Відкрийте застосунок і натисніть Initialize, щоб створити новий сервер
3. Дотримуйтеся інструкцій застосунку, щоб додати його інструменти командного рядка до PATH
4. Перевірте встановлення:

psql --version

Postgres.app також створює суперкористувача з іменем вашого облікового запису macOS.

Налаштування веб‑сервера¶

digna потребує веб‑сервера для розміщення панелі. Виберіть один із таких варіантів:

• nginx — встановлюється через Homebrew, рекомендований
• Apache httpd — входить до складу macOS

Потрібно встановити й налаштувати лише один із цих серверів.

Обидва розділи налаштовують дві речі, від яких залежить панель:

• Резервний маршрут для односторінкового застосунку (SPA fallback), щоб оновлення URL панелі не повертало 404
• Тип MIME для .md, щоб файли Markdown віддавалися коректно

Налаштування nginx¶

Огляд¶

nginx — легкий високопродуктивний веб‑сервер, що добре підходить для віддавання статичної панелі digna.

Встановлення¶

brew install nginx

Запуск nginx¶

brew services start nginx

Перевірте встановлення¶

1. Відкрийте браузер
2. Перейдіть за адресою http://localhost:8080
3. Ви повинні побачити сторінку привітання nginx

Налаштування сайту для панелі¶

Конфігурація nginx від Homebrew підключає кожен файл зі свого каталогу servers. Створіть там окремий файл конфігурації для digna:

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

Вставте наведене нижче, замінивши /path/to/digna/dashboard фактичним шляхом до розпакованої теки dashboard:

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;
    }
}

Застосуйте конфігурацію¶

Перевірте конфігурацію на синтаксичні помилки, а потім перезавантажте nginx:

nginx -t
brew services restart nginx

Налаштування Apache httpd¶

Огляд¶

Apache httpd входить до складу macOS, тож установлювати його не потрібно. За замовчуванням він вимкнений.

Запуск Apache¶

sudo apachectl start

Перевірте встановлення¶

1. Відкрийте браузер
2. Перейдіть за адресою http://localhost
3. Ви повинні побачити повідомлення "It works!"

Обов'язково: увімкніть mod_rewrite¶

Панель потребує перезапису URL. Відкрийте конфігурацію Apache:

sudo nano /etc/apache2/httpd.conf

Знайдіть наведений нижче рядок і видаліть початковий символ #, щоб розкоментувати його:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Обов'язково: дозвольте перевизначення через .htaccess¶

У тому самому файлі знайдіть блок <Directory "/Library/WebServer/Documents"> і змініть:

AllowOverride None

на:

AllowOverride All

Обов'язково: тип MIME для файлів Markdown¶

Там само в httpd.conf додайте такий рядок, щоб файли Markdown віддавалися коректно:

AddType text/markdown .md

Застосуйте конфігурацію¶

Перевірте конфігурацію на синтаксичні помилки, а потім перезапустіть Apache:

sudo apachectl configtest
sudo apachectl restart

Початкове встановлення¶

Крок 1: Налаштуйте репозиторій digna¶

Репозиторій digna зберігає всі метрики, обчислені digna. Він слугує центральною базою даних для аналітичних даних і даних про продуктивність.

Створіть схему репозиторію та користувача¶

Відкрийте свій клієнт PostgreSQL (psql, pgAdmin або подібний) і виконайте такі 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>;

Замініть такі заповнювачі:

• <digna_repo_schema> — бажана назва схеми (наприклад, dignarepo)
• <digna_repo_user> — бажане ім'я користувача (наприклад, digna_user)
• <digna_repo_password> — надійний пароль для цього користувача

Приклад:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Щоб виконати їх із Terminal за один крок:

psql postgres

Потім вставте оператори в запрошенні postgres=# і введіть \q, щоб вийти.

Крок 2: Розпакуйте інсталяційний пакет digna¶

1. Знайдіть наданий вам ZIP‑файл інсталяції digna
2. Розпакуйте його в бажане місце встановлення — наприклад, /opt/digna або ~/digna
3. Після розпакування ви побачите такі елементи:
4. dashboard/ — веб‑інтерфейс панелі
5. digna — основний виконуваний файл (серверна частина та CLI разом)

Щоб розпакувати з Terminal:

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

Зробіть файл виконуваним¶

Залежно від того, як передавався архів, біт виконання може не зберегтися після розпакування. Задайте його явно:

cd /opt/digna
chmod +x digna

Якщо macOS блокує застосунок¶

Файли, завантажені через браузер або поштовий клієнт, позначаються атрибутом карантину. Якщо macOS повідомляє, що застосунок «неможливо відкрити, оскільки не вдається перевірити розробника», зніміть цей атрибут із каталогу встановлення:

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

Або ж відкрийте System Settings → Privacy & Security, знайдіть заблокований елемент унизу сторінки й натисніть Open Anyway.

Крок 3: Встановіть файл ліцензії¶

1. Знайдіть наданий вам файл license.toml
2. Скопіюйте його в кореневий каталог встановлення digna (там, де розташовані config.toml і виконуваний файл digna)

Чому це важливо: Файл ліцензії містить відомості про клієнта, дату закінчення терміну дії ліцензії та цифровий підпис. Не змінюйте цей файл — будь‑які зміни зроблять його недійсним.

Структура каталогу після налаштування:

/opt/digna/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
├── bin/                (service management scripts)
└── dashboard/          (web interface)
    └── (dashboard files)

Налаштування серверної частини¶

Крок 1: Створіть і відредагуйте файл конфігурації¶

Файл config_template.toml постачається у вашому каталозі встановлення digna. Потрібно лише перейменувати його на config.toml.

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

Розташування: /opt/digna/config.toml

Відкрийте config.toml у текстовому редакторі й налаштуйте кожен із наведених нижче розділів.

Розділ [app]¶

Цей розділ налаштовує спільне використання ресурсів між джерелами (CORS) для панелі та серверної частини:

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

Розділ [repo]¶

Цей розділ налаштовує підключення до бази даних 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

Розділ [base]¶

Цей розділ містить параметри безпеки, cookie та інспекцій:

[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

Розділ [encryption]¶

Цей розділ містить ключ, яким шифруються конфіденційні значення, що зберігаються в репозиторії. Він обов'язковий — config check повідомляє про розділ [encryption] як FAILED, якщо ключа немає.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Розділ [logging]¶

Цей розділ налаштовує поведінку журналювання:

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

Розділ [duckdb] (необов'язковий)¶

Нове в Release 2026.11. Цей розділ задає ресурси digna Engine, який профілює дані всередині digna для підключень до баз даних, місцем профілювання яких є digna Engine, і виконує перевірки референтної цілісності між джерелами даних на різних підключеннях до баз даних. Див. Місце профілювання.

Розділ необов'язковий. Без нього діють наведені нижче значення за замовчуванням.

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

mkdir -p /opt/digna/tmp

Крок 2: Перевірте конфігурацію¶

Перед ініціалізацією репозиторію переконайтеся, що config.toml повний і правильно сформований. У каталозі встановлення digna виконайте:

./digna config check

Кожен розділ перевіряється окремо, тож одна помилка не приховує стан решти:

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

Виправте все, про що повідомлено як FAILED, і виконайте команду ще раз, перш ніж продовжувати. WARNING у пункті Unknown keys перелічує ключі в config.toml, які digna не зчитує; вони ні на що не впливають, тож вилучіть їх або виправте їхнє написання. Повний перелік параметрів наведено в довіднику CLI.

Крок 3: Ініціалізуйте репозиторій¶

1. Відкрийте Terminal
2. Перейдіть до каталогу встановлення digna (там, де розташовані config.toml і виконуваний файл digna)
3. Запустіть перевірку підключення:

cd /opt/digna
./digna repo check

Для нової схеми команда підключається, а потім повідомляє, що репозиторій ще не встановлено:

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

На цьому етапі це очікуваний результат: він підтверджує, що digna дістається до PostgreSQL і схеми. Натомість помилка підключення чи автентифікації вказує на розділ [repo] або на налаштування PostgreSQL.

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

Крок 4: Встановіть схему репозиторію¶

У тому самому каталозі виконайте:

./digna repo upgrade

Ця команда встановлює необхідні таблиці у схемі репозиторію й завершується повідомленням:

✅ Repo schema 'dignarepo' is up to date.

Крок 5: Створіть користувача‑адміністратора¶

Користувач‑адміністратор створюється безпосередньо у схемі репозиторію, тож сервер поки що не мусить працювати. У каталозі встановлення digna виконайте:

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

Приклад:

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

Це створює користувача з адресою електронної пошти admin@example.com і повними адміністративними правами.

Крок 6: Запустіть сервер digna¶

У каталозі встановлення digna запустіть сервер командою:

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

Параметри: - --address — ім'я хоста / IP сервера (за замовчуванням 127.0.0.1) - --port — порт сервера (за замовчуванням 8000)

Коли сервер запущено, він виводить адресу, яку прослуховує:

Server running on http://127.0.0.1:8082

Налаштування панелі¶

Крок 1: Розгорніть панель на веб‑сервері¶

Панель digna зчитує власну конфігурацію з dashboard/dashboard_config.toml. Цей файл не постачається разом зі встановленням — ви створюєте його в каталозі dashboard/ поруч із файлами панелі.

Його вміст описано в розділі Single Sign-On, і саме там цей файл і потрібен: він містить варіанти входу, які пропонує панель, а для розгортань із кількома екземплярами — підключення до серверної частини.

Виберіть свій веб‑сервер і виконайте відповідні кроки розгортання.

Розгортання в nginx¶

Якщо ви виконали кроки розділу Налаштування nginx, блок server уже вказує на вашу теку dashboard, і нічого копіювати не потрібно.

1. Перевірте шлях
2. Відкрийте $(brew --prefix)/etc/nginx/servers/digna.conf

3. Переконайтеся, що root вказує на розпаковану теку dashboard

4. Переконайтеся, що теку можна читати

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

5. Перезавантажте nginx

   nginx -t
   brew services restart nginx
   

6. Перевірте встановлення

7. Відкрийте браузер
8. Перейдіть за адресою http://localhost:8080 (або за налаштованим вами URL)
9. Ви повинні побачити сторінку входу панелі digna

Розгортання в Apache httpd¶

1. Скопіюйте панель до кореневого каталогу документів

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

2. Додайте правила перезапису

Створіть файл .htaccess у розгорнутій теці, щоб маршрути панелі зберігалися після оновлення сторінки в браузері:

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

Вставте наведене нижче:

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. Перезапустіть Apache

   sudo apachectl restart
   

2. Відкрийте панель

3. Відкрийте браузер
4. Перейдіть за адресою http://localhost/digna
5. Ви повинні побачити сторінку входу панелі digna

Запуск digna як фонової служби¶

Навіщо запускати digna як службу?¶

Запуск серверної частини digna як фонової служби гарантує, що вона:

• Автоматично запускається під час завантаження машини
• Працює у фоновому режимі без відкритого вікна Terminal
• Автоматично перезапускається в разі збою
• Керується через launchctl — менеджер служб macOS

Файли керування службою¶

Усі необхідні файли розташовані в каталозі встановлення digna, у підкаталозі bin/

Доступні такі скрипти оболонки:

• install_service.sh — реєструє digna в launchd
• uninstall_service.sh — скасовує реєстрацію служби
• start_service.sh — запускає зареєстровану службу
• stop_service.sh — зупиняє запущену службу

Як зробити скрипти виконуваними¶

Розпакування може не зберегти біт виконання. Перед першим використанням виконайте:

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

Встановлення служби¶

1. Відкрийте Terminal

2. Перейдіть до теки bin

   cd /opt/digna/bin
   

3. Запустіть скрипт встановлення

   sudo ./install_service.sh
   

Тепер сервер digna зареєстровано в launchd з увімкненим автоматичним запуском. Служба не запускається одразу — щоб запустити її, див. наступний розділ.

Запуск і зупинка служби¶

Щоб запустити службу¶

1. Відкрийте Terminal
2. Перейдіть до /opt/digna/bin
3. Виконайте:

   sudo ./start_service.sh
   

Щоб зупинити службу¶

1. Відкрийте Terminal
2. Перейдіть до /opt/digna/bin
3. Виконайте:

   sudo ./stop_service.sh
   

Перевірка служби¶

Щоб переконатися, що службу зареєстровано й вона працює:

sudo launchctl list | grep digna

Рядок, що починається з ідентифікатора процесу, означає, що служба працює. Символ - у першому стовпці означає, що службу зареєстровано, але її зупинено.

Перенесення служби до нового каталогу¶

launchd зберігає абсолютний шлях до виконуваного файлу, тож перенесення встановлення потребує повторної реєстрації служби:

1. Видаліть поточну службу

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

2. Перемістіть файли застосунку

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

3. Повторно встановіть службу

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

4. Запустіть службу

   sudo ./start_service.sh
   

Видалення служби¶

1. Зупиніть запущену службу

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

2. Видаліть службу

   sudo ./uninstall_service.sh
   

Реєстрацію сервера digna в launchd скасовано.

Оновлення до нового випуску¶

Цей розділ описує оновлення встановлення Release 2026.06 до Release 2026.11. Якщо ваше встановлення старіше, спершу прочитайте розділ Оновлення з випуску, старішого за 2026.06.

Перед оновленням¶

Створення резервної копії репозиторію digna обов'язкове

Перед оновленням digna створіть резервну копію свого репозиторію (PostgreSQL), щоб захиститися від втрати даних. Резервна копія дає змогу відновитися, якщо під час оновлення виникнуть непередбачені проблеми.

Щоб створити резервну копію з Terminal:

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

Запит файлу ліцензії для Release 2026.11

Release 2026.11 потребує нового license.toml. Запросіть його в команди digna до початку оновлення та майте його напоготові для кроку 7.

Оновлення з випуску, старішого за 2026.06¶

Release 2026.06 приніс три зміни, які досі діють, коли ви оновлюєте старіше встановлення одразу до 2026.11:

• Лише ODBC. digna звертається до кожної технології-джерела через ODBC. Кожне підключення до бази даних, яке ще не використовує ODBC, після оновлення потрібно перевести на ODBC; автоматичного перетворення немає. Заздалегідь встановіть драйвери ODBC на хості digna, див. Встановлення драйвера ODBC на хості digna, і підготуйте властивості кожного підключення з посібників за технологіями. Конектора Databricks Legacy більше не існує; переведіть такі підключення на конектор Databricks.
• Один виконуваний файл. dignabackend і dignacli замінено одним виконуваним файлом digna, що поєднує серверну частину та CLI.
• config.toml. Розділ [encryption] обов'язковий, а DIGNA_APP_HOST і DIGNA_APP_PORT більше не зчитуються: адресу та порт сервер бере з digna serve. Порівняйте свій файл із розділом Налаштування серверної частини.

Наведені нижче кроки вказують, де старіше встановлення потребує інших дій. Оновлення репозиторію в кроці 8 переводить репозиторій будь-якого попереднього випуску одразу до 2026.11.

Процес оновлення¶

Крок 1: Зупиніть службу digna¶

Якщо digna працює як фонова служба, спершу зупиніть її:

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

Якщо digna працює на передньому плані, натисніть Ctrl+C у її вікні Terminal.

Крок 2: Створіть резервну копію поточного встановлення¶

У каталозі встановлення digna перейменуйте виконуваний файл і теку панелі поточного встановлення, щоб новий випуск можна було розгорнути поруч із ними:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Зберігайте digna_old, доки не перевірите оновлення, а dashboard_old — доки не відновите з неї свої файли конфігурації (див. крок 4). Після цього обидва можна видалити.

Крок 3: Розпакуйте та розгорніть нову версію¶

1. Розпакуйте ZIP‑файл нової інсталяції digna
2. Скопіюйте новий виконуваний файл digna і теку dashboard до свого каталогу встановлення
3. Відновіть біт виконання та за потреби зніміть атрибут карантину:

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

Крок 4: Відновіть свої файли конфігурації¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 не потребує змін у config.toml: файл, який працює з Release 2026.06, і далі працюватиме. Дві зміни необов'язкові:

• Додайте розділ [duckdb], якщо підключення до баз даних мають використовувати digna Engine, а його значення за замовчуванням не підходять для вашого хоста.
• Не вказуйте розділ [app], якщо зворотний проксі віддає панель і серверну частину з одного джерела.

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

Крок 5: Перезавантажте веб‑сервер¶

Панель — це набір статичних файлів, тож ваш веб‑сервер — і браузер — можуть досі віддавати попередню версію. Перезавантажте або перезапустіть веб‑сервер, на якому розміщено теку dashboard, а потім перезавантажте сторінку з примусовим оновленням (Cmd+Shift+R).

Крок 6: Перевірте конфігурацію¶

Перш ніж торкатися репозиторію, переконайтеся, що config.toml повний:

./digna config check

Кожен розділ має повідомити OK. Виправте все, про що повідомлено як FAILED, вилучіть ключі, перелічені в пункті Unknown keys, і виконайте команду ще раз, перш ніж продовжувати.

Крок 7: Замініть файл ліцензії¶

Файл ліцензії зазвичай переходить з одного випуску в наступний. Release 2026.11 — виняток: він додає два ліцензовані модулі, digna Data Reconciliation і digna Agentic, а ліцензія, видана до 2026.11, їх не містить. Скопіюйте license.toml, який команда digna надала для Release 2026.11, до каталогу встановлення, замінивши старий:

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

./digna license check

Крок 8: Оновіть схему репозиторію¶

У каталозі встановлення digna виконайте:

cd /opt/digna
./digna repo upgrade

Release 2026.11 керує схемою репозиторію за допомогою версійованих міграцій. Перше оновлення з попереднього випуску доводить схему до останньої версії попередньої системи, записує це як вихідну точку, а потім застосовує міграції Release 2026.11. Воно завершується так:

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

Усі наявні дані зберігаються. Щоб будь-коли побачити стан репозиторію, виконайте ./digna repo check: команда показує останню застосовану міграцію та всі ще не застосовані.

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

Крок 9: Перезапустіть служби¶

Якщо digna працює як фонова служба:

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

Якщо сервер запускається вручну, перезапустіть його:

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

Якщо використовуєте nginx або Apache, перезапустіть відповідний веб‑сервер:

brew services restart nginx

sudo apachectl restart

Крок 10: Перевірте оновлення¶

1. Перевірте випуск нового виконуваного файлу:

   ./digna version
   

   Перший рядок має бути Release: 2026.11.

2. Відкрийте панель digna і переконайтеся, що інтерфейс завантажується коректно.

3. Перевірте вивід сервера та файли в каталозі logs на наявність помилок.
4. Перевірте свої підключення до баз даних — див. Перевірка підключення. Після оновлення з випуску, старішого за 2026.06, спершу переведіть на ODBC кожне підключення, яке його ще не використовувало.

Щоб почати роботу з новими модулями, див. digna Data Reconciliation, Підключення AI-агента для digna MCP Server і Місце профілювання для digna Engine.