Files

51 lines
1.7 KiB
Markdown

# 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.