Установка
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, появится обычный вход. Используйте прежний пароль; распаковка нового архива не создаёт нового администратора.
После входа появилось основное меню. Откройте «Подключения» — отсюда начинается работа с базами.
Добавьте первую базу
На новой установке список баз в «Подключениях» пуст. Нажмите «Добавить узел», чтобы добавить свою базу Паруса; учётные данные базы вводятся отдельно от пароля admin в Holkas.
Дальше — параметры базы, проверка связи и каталог объектов. Начните с тестовой базы, чтобы пройти первый пример.
Проверено на 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 и текст ошибки из консоли без паролей и обратитесь в поддержку.
Дальше
- Подключить базу и найти объекты — от параметров до первого плана.
- Обновить Holkas — заменить программу и сохранить данные.
- Сделать резервную копию — что копировать и как восстановить.