Qortal-Nextcloud-Integration/scripts/README.md

Scripts Organization

This repository keeps script entrypoints stable while grouping new logic into subfolders.

Top-level entrypoints

These are the commands you can run directly:

• scripts/install-production-docker.sh
• scripts/finish-initial-setup.sh
• scripts/install-host-nextcloud-hybrid.sh
• scripts/update-host-nextcloud-hybrid.sh
• scripts/restart-host-nextcloud-hybrid.sh
• scripts/stop-host-nextcloud-hybrid.sh
• scripts/nuqloud-lifecycle.sh
• scripts/patch-user-oidc-invite-flow.sh
• scripts/setup-appstore-mimic.sh
• scripts/ensure-*.sh
• scripts/discover-cloud-topology.sh
• scripts/apply-topology-profile.sh
• scripts/diagnose-*.sh

Useful diagnostics:

• scripts/diagnose-nextcloud-occ-readiness.sh
• scripts/diagnose-qortal-gateway-route.sh

Subfolders

scripts/topology/

Topology-aware setup scaffolding for app-store style installation paths:

• discover-cloud-topology.sh
  • detects runtime shape (repo Docker stack vs host Nextcloud)
  • outputs recommendation as JSON or text
• ../nuqloud-lifecycle.sh
  • smart start/update/rebuild/stop wrapper for repo devprod and host-hybrid installs
  • delegates to the existing mature lifecycle scripts after topology detection
• apply-topology-profile.sh
  • applies recommended profile using existing install/recreate scripts
  • currently implemented profiles:
    • repo-devprod-bootstrap
    • host-nextcloud-hybrid (delegates to the host-hybrid installer)

Compatibility policy

• Existing top-level script names remain valid.
• New grouped scripts may be called via top-level wrapper scripts.
• Future refactors should preserve wrappers so user workflows do not break.