Запуск в Docker

Требования

• Docker Engine 24+ или актуальная версия Docker Desktop.
• Компьютер с архитектурой x86-64 (linux/amd64).
• Сетевой доступ из контейнера к базам данных и хранилищам, с которыми будет работать Holkas.

Важно. Сделайте резервную копию приёмника до первого применения плана. Holkas показывает команды заранее, но откат выполняется средствами СУБД, а не приложением.

Запуск с помощью docker run

docker volume create holkas-data

docker run -d \
  --name holkas \
  --restart unless-stopped \
  -p 8080:8080 \
  -v holkas-data:/data \
  -e HolkasWeb__BootstrapAdminPassword='задайте-сложный-пароль' \
  belousov2501/holkas:latest

Откройте http://localhost:8080. Данные начальной учётной записи:

Имя пользователя: admin
Пароль: значение HolkasWeb__BootstrapAdminPassword

После первого входа смените пароль. Начальное значение используется только в том случае, если в базе ещё нет пользователей. Последующее изменение переменной не сбрасывает пароль существующего администратора.

Параметры

Образ уже настроен на режим Standalone, порт 8080 и каталог данных /data, поэтому для первого запуска достаточно пароля. Всё остальное — режим, пути, адрес, политика хранения операций — задаётся переменными окружения так же, через -e; полный список на странице параметров запуска. Например, хранить груз операций 90 дней вместо 30:

  -e HolkasWeb__Retention__Days=90 \

Запуск с помощью Docker Compose

Создайте файл compose.yaml:

services:
  holkas:
    image: belousov2501/holkas:latest
    container_name: holkas
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      HolkasWeb__BootstrapAdminPassword: ${HOLKAS_ADMIN_PASSWORD}
      # Остальные параметры — /install/settings, например:
      # HolkasWeb__Retention__Days: 90
    volumes:
      - holkas-data:/data

volumes:
  holkas-data:

В том же каталоге создайте файл .env:

HOLKAS_ADMIN_PASSWORD=задайте-сложный-пароль

Ограничьте доступ к этому файлу и не добавляйте его в git. Запустите сервис:

docker compose up -d
docker compose logs -f holkas

Фиксация версии

Тег latest указывает на последний успешный релиз. Если вам нужна предсказуемая установка, используйте номер конкретной версии:

image: belousov2501/holkas:0.1.4

Доступные теги перечислены на Docker Hub.

Что хранится в томе

В томе holkas-data лежат база состояния SQLite, артефакты операций, журналы, ключи Data Protection и материалы для подписи токенов. Не удаляйте том во время обновления; как его копировать, сказано на странице резервной копии.