Резервная копия

Docker

Перед файловым копированием /data остановите Holkas. В этом каталоге находятся база SQLite, артефакты, журналы, ключи Data Protection и материалы для подписи токенов — резервная копия должна сохранять их вместе.

docker stop holkas
docker run --rm -v holkas-data:/data -v "$PWD":/backup alpine \
  tar czf /backup/holkas-data.tgz -C /data .
docker start holkas

Не удаляйте том holkas-data во время обновления.

Windows

Остановите Holkas.Web.exe и скопируйте каталог data целиком. Восстановление — распаковать его на прежнее место и указать в HolkasWeb__DataPath и HolkasWeb__StatePath.

Сеть и безопасность

• Не публикуйте Holkas напрямую в интернете.
• Для удалённого доступа используйте обратный прокси с TLS и ограничение сетевого доступа.
• Используйте режим Standalone, если вы осознанно не настроили Team.
• Считайте токены, реквизиты баз данных, ключи S3 и данные доступа к Git секретами.
• До применения изменений проверьте план переноса и подготовьте рабочую резервную копию целевой базы данных.

Если что-то не так

Не открывается веб-интерфейс. Проверьте журнал процесса или контейнера и убедитесь, что выбранный порт свободен:

docker logs holkas
docker ps --filter name=holkas
curl http://localhost:8080/api/v1/auth/me

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

Не устанавливается соединение с базой данных. Адрес базы разрешается на компьютере или внутри контейнера с Holkas, а не в браузере. В Docker адрес localhost указывает на сам контейнер Holkas. Используйте доступное DNS-имя, IP-адрес компьютера или сетевой псевдоним Docker для сервера базы данных.