This repository was archived by the owner on May 30, 2026. It is now read-only.
feat(deploy): host-native and Docker deployment for Ouroboros Desktop - #27
Open
keXXpert wants to merge 1 commit into
Open
feat(deploy): host-native and Docker deployment for Ouroboros Desktop#27keXXpert wants to merge 1 commit into
keXXpert wants to merge 1 commit into
Conversation
keXXpert
force-pushed
the
pr/upstream-docker-host-clean
branch
2 times, most recently
from
May 1, 2026 06:33
d2a80ae to
604e64f
Compare
Author
|
Добавил второй вариант деплоя (bare-metal), сквошнул все коммиты, убрал лишние правки в github actions, Dockerfile и Readme |
Add deploy/docker for a containerized VPS-style stack (compose, env templates, systemd unit, backup/restore, update and doctor flows). Add deploy/host for installing and running directly on the host with dedicated user, parallel scripts, systemd integration, and the same operational tooling.
kexx-ai-coder
force-pushed
the
pr/upstream-docker-host-clean
branch
from
May 1, 2026 13:47
604e64f to
7ca4145
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Host-native and Docker deployment for Ouroboros Desktop
Summary
This pull request adds two complementary deployment layouts for running Ouroboros Desktop in headless environments on Linux (Ubuntu-first):
deploy/docker/— containerized VPS profile: Docker Compose, env templates, systemd unit on the host, backup/restore, update with rollback, and diagnostics.deploy/host/— bare-metal profile: install and operate the app directly on the machine with parallel scripts, systemd integration, and the same operational surface (update, backup/restore, doctor).The goal is a reproducible operator story: one entrypoint per profile, consistent metadata and ref tracking, and less ad-hoc glue on servers.
Why
Source and generic Docker instructions exist, but production-style VPS and “install on the host” flows benefit from a single scripted surface (install, update, rollback, backup, diagnose) aligned with how operators actually run services.
What’s included
Docker (VPS) profile —
deploy/docker/install.sh— staged/resumable installer, interactive and non-interactive modes, one-linecurl | bashstyle bootstrap.docker-compose.vps.yml,ouroboros-headless.service— compose stack plus host systemd integration.update.sh,backup.sh,restore.sh,doctor.sh,enable-browser-tools.sh,systemd-healthcheck.sh.common.sh— env helpers, security-oriented checks (bind mounts, secrets, file layout), compose wrappers, health wait, deploy metadata.README.md,.env.example— operator documentation and a safe template for required variables.Host-native profile —
deploy/host/install.sh,update.sh,backup.sh,restore.sh,doctor.sh,enable-browser-tools.sh,common.sh, systemd unit (ouroboros.service), health check helper.README.md,.env.examplefor host-specific paths and conventions.Repository hygiene
.gitignore— keep real.envfiles and secrets out of git while continuing to trackdeploy/**/.env.exampleas documentation; ignore local.deploy/metadata used at runtime.Notes for maintainers
Validation
bash -non deploy shell scripts where applicable; review of compose and systemd units.deploy/docker/**can be proposed separately if desired.)Хостовый и Docker-деплой для Ouroboros Desktop
Кратко
Два варианта деплоя для headless сценариев:
deploy/docker/(VPS в контейнерах) иdeploy/host/(установка прямо на машине), с единообразными скриптами эксплуатации и документацией.Зачем
Упростить воспроизводимую эксплуатацию: установка, обновление, откат, бэкап и диагностика через согласованный набор скриптов, а не разрозненные шаги.
Что внутри
См. английскую секцию выше: структура зеркальная для docker и host профилей (install/update/backup/restore/doctor, systemd,
common.sh, README и.env.example).Комментарий
Только поверхность деплоя; правки
.gitignore— чтобы не коммитить секреты и при этом оставить в репозитории примерыdeploy/**/.env.example.