Skip to content

Switch deployment flow from git clone to compose.yaml download#379

Open
ivenos wants to merge 2 commits into
LogicLabs-OU:mainfrom
ivenos:simplify-deployment
Open

Switch deployment flow from git clone to compose.yaml download#379
ivenos wants to merge 2 commits into
LogicLabs-OU:mainfrom
ivenos:simplify-deployment

Conversation

@ivenos
Copy link
Copy Markdown

@ivenos ivenos commented May 23, 2026

Depends on #378 (which renames docker-compose.yml to compose.yaml). The diff below assumes that rename has landed.

The Open Archiver image is self-contained: backend, frontend, types, migrations, and the entrypoint are all baked in at build time. Nothing from the source tree is read at runtime, so cloning the repository just to start the application is unnecessary.

Changes

  • README and installation guide now instruct users to download compose.yaml and .env.example directly, instead of cloning the repo.
  • The upgrade guide drops the git pull step. docker compose pull + docker compose up -d is enough; re-downloading compose.yaml is only needed when a release explicitly changes it.
  • Removes the broken reference to .env.example.docker (file does not exist in the repo).
  • Git is no longer listed as a prerequisite.

Impact on existing users

None. Existing clones keep working with the unchanged docker compose commands. The new flow is only what new users see in the docs.

ivenos added 2 commits May 23, 2026 22:27
Aligns the project with the current Compose Specification, which
designates compose.yaml as the canonical filename and treats the
docker-compose.yml name as a legacy fallback. The top-level version
field is also removed: it is declared informational and obsolete by the
Compose Spec, and modern Docker engines emit a warning when it is
present.

All documentation references are updated accordingly. Functional
behavior is unchanged — docker compose discovers either filename, so
existing deployments are not affected by the rename.

Reference: https://docs.docker.com/compose/intro/compose-application-model/
The Open Archiver image is self-contained: backend, frontend, types,
migrations, and the entrypoint are all baked in at build time. Nothing
from the source tree is read at runtime, so cloning the repository just
to start the application is unnecessary.

This change updates the README and the installation/upgrade guides to
download compose.yaml and .env.example directly. The update flow drops
the git pull step accordingly; re-downloading compose.yaml is only
needed when a release explicitly changes it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant