Holkas
Написать в поддержку Поддержка

Установка

Windows x64

Скачайте архив и запустите Holkas.Web.exe. Инструкция показывает Standalone — вход по логину и паролю; на своей машине можно выбрать Local без входа, а для корпоративного SSO — Team.

На этой странице

Скачайте веб-сборку

Откройте последний релиз. В Assets выберите holkas-web-win-x64-<версия>.zip; рядом скачайте SHA256SUMS для проверки архива.

У вас архив с web в имени. Архив holkas-cli-win-x64 содержит клиент командной строки; для этого запуска нужен именно Holkas Web.

Распакуйте в постоянную папку

Извлеките весь архив, например в C:\Holkas. Внутри появится папка holkas-web-win-x64. Запускайте программу из распакованной папки, сохранив все файлы рядом с ней.

В папке C:\Holkas\holkas-web-win-x64 есть файл Holkas.Web.exe.

Запустите Holkas.Web.exe

Дважды нажмите на Holkas.Web.exe. Открывшееся окно консоли — работающий сервер Holkas; оставьте его открытым. В журнале запуска указаны адрес и каталог данных.

Set-Location -LiteralPath 'C:\Holkas\holkas-web-win-x64'
.\Holkas.Web.exe

Можно запустить файл двойным щелчком или выполнить команды выше в PowerShell — так сообщения останутся перед глазами. В браузере на этом же компьютере откройте http://localhost:5000. Если окно сразу исчезло или адрес недоступен, воспользуйтесь подсказками ниже.

Окно программы остаётся открытым, в нём есть Now listening on: http://localhost:5000, а браузер показывает Holkas.

Первый вход в Standalone

На экране «Первый запуск» введите новый пароль администратора дважды — не короче 8 символов. Нажмите «Задать пароль и войти». Имя пользователя для последующих входов — admin.

Если на компьютере уже есть данные Holkas, появится обычный вход. Используйте прежний пароль; распаковка нового архива не создаёт нового администратора.

Первый запуск Holkas — создание пароля администратора admin
Первый запуск Windows-сборки Holkas 0.1.20. Пароль создаётся здесь; это отдельная учётная запись Holkas, а не пароль пользователя Windows.

После входа появилось основное меню. Откройте «Подключения» — отсюда начинается работа с базами.

Добавьте первую базу

На новой установке список баз в «Подключениях» пуст. Нажмите «Добавить узел», чтобы добавить свою базу Паруса; учётные данные базы вводятся отдельно от пароля admin в Holkas.

Раздел Подключения до добавления первой базы Паруса
Раздел «Подключения» на чистой Windows-установке после входа. Базы добавляются отдельно — распаковка программы их не подключает.

Дальше — параметры базы, проверка связи и каталог объектов. Начните с тестовой базы, чтобы пройти первый пример.

Проверено на Windows

Версия 0.1.20 проверена 21 октября 2026 года на Windows 10 Enterprise LTSC 21H2 x64, сборка 19044, с PowerShell 5.1. Проверка началась с чистой папки данных и официального ZIP-архива, сверенного с SHA256SUMS.

  • Программа запускается из распакованной папки и открывает http://localhost:5000.
  • Первый пароль задаётся в браузере. После остановки и повторного запуска прежний пароль и сеанс входа сохраняются, повторная настройка не нужна.
  • Данные остаются в %LOCALAPPDATA%\Holkas, даже если программу запускают из другого рабочего каталога.
  • Windows-сервер подключился к учебному PostgreSQL Паруса; Windows CLI построил план и выгрузил функцию в ZIP. План в базу не применяли.
  • Проверены обновление 0.1.18 → 0.1.20 и полная копия с восстановлением в новую папку. Сохранились вход, настройки подключений, манифест и файл операции.

Это проверка указанной системы и режима Standalone. Она не заменяет таблицу совместимости Windows с .NET и не подтверждает запуск в качестве службы или настройку корпоративного SSO.

Где лежат данные

По умолчанию данные сохраняются в %LOCALAPPDATA%\Holkas того пользователя Windows, который запускает программу. Вставьте этот путь в адресную строку Проводника, чтобы открыть папку. Здесь база состояния, файлы операций, журналы и ключи; это данные экземпляра Holkas, а не база Паруса.

При обновлении заменяются файлы программы; каталог данных остаётся. Запуск под другим пользователем Windows использует другую папку и может показать чистый экземпляр. Чтобы перенести существующую установку, следуйте инструкции резервного копирования.

Если у прежней версии данные лежали в holkas-data в рабочем каталоге или рядом с программой, Holkas при первом запуске скопирует их в системную папку, если там ещё нет базы состояния и пути не заданы явно. О переносе будет сообщение в консоли; старый каталог автоматически не удаляется.

Проверка архива

Архив и SHA256SUMS должны быть из одного релиза. Поместите их в одну папку, откройте в ней PowerShell и выполните команды. В примере — имя архива последнего выпуска; если скачали другую версию, замените его на имя своего файла:

$archive = 'holkas-web-win-x64-0.1.36.zip'
$rows = @(Get-Content .\SHA256SUMS | Where-Object {
    ($_ -split '\s+', 2)[1] -eq $archive
})
if ($rows.Count -ne 1) {
    throw 'Не найдена единственная контрольная сумма для этого архива'
}
$expected = ($rows[0] -split '\s+', 2)[0]
$actual = (Get-FileHash -LiteralPath $archive -Algorithm SHA256).Hash
if ($actual -ne $expected) {
    throw 'Сумма не совпадает. Скачайте архив заново и не запускайте этот файл'
}
'Контрольная сумма совпадает'

Результат — «Контрольная сумма совпадает». Это проверка соответствия опубликованному архиву; загружайте оба файла с официальной страницы релиза.

Свои настройки

Другой порт или папка данных задаются переменными окружения до запуска. Например, остановите Holkas и выполните в PowerShell:

$env:HolkasWeb__DataPath = 'D:\HolkasData'
$env:ASPNETCORE_URLS = 'http://localhost:5080'
& 'C:\Holkas\holkas-web-win-x64\Holkas.Web.exe'

В этом примере адрес — http://localhost:5080. Переменные действуют в текущем окне PowerShell и запущенной из него программе. Чтобы повторять запуск с теми же параметрами, сохраните команды в .ps1 и запускайте его согласно принятой у вас политике выполнения сценариев.

Указание нового каталога не переносит туда прежние данные автоматически. Сначала перенесите полный каталог остановленного экземпляра по инструкции резервного копирования, если хотите продолжить с прежними подключениями и пользователями. Список настроек — в параметрах запуска.

Если запуск не получился

Что видитеЧто проверить и сделать
Windows предупреждает о неизвестном приложенииСборка пока не подписана. Проверьте источник и контрольную сумму. Если правила вашей организации допускают запуск, в SmartScreen можно выбрать «Подробнее» → «Выполнить в любом случае»; если такой кнопки нет, обратитесь к администратору.
Окно сразу закрываетсяОткройте PowerShell, выполните & 'C:\Holkas\holkas-web-win-x64\Holkas.Web.exe' и прочитайте оставшуюся в окне ошибку. Сверьте путь с вашей папкой.
Ошибка занятия порта 5000Возможно, Holkas уже запущен: сначала откройте localhost:5000. Если порт занят другой программой, задайте свободный через ASPNETCORE_URLS, как в примере выше.
Браузер не может открыть страницуУбедитесь, что программа работает, а адрес совпадает с Now listening on в консоли. Открывайте его на той машине, где запущен Holkas.
После закрытия консоли сайт перестал работатьОстановка процесса останавливает и веб-интерфейс. Снова запустите Holkas.Web.exe; данные сохранятся. Для завершения работы используйте Ctrl+C в консоли.
Вместо прежних данных — «Первый запуск»Проверьте пользователя Windows и путь данных в консоли. Возможно, запущен другой экземпляр или задан новый HolkasWeb__DataPath.
Holkas открылся, но не подключается к базеЗапуск приложения завершён. Дальше проверяются адрес, порт и учётные данные базы — в инструкции подключений.

Если ошибка остаётся, подготовьте версию Holkas и текст ошибки из консоли без паролей и обратитесь в поддержку.

Дальше