2.1 KiB
2.1 KiB
Script Reference
Root Scripts
start-dev.sh- Interactive setup for local development stack (
docker-compose.yml).
- Interactive setup for local development stack (
start-devprod.sh- Interactive setup for dev-prod stacks (
docker-compose.devprod*.yml).
- Interactive setup for dev-prod stacks (
recreate-devprod.sh- Rebuild/recreate dev-prod services after code/env changes.
- Use
--qortalto includeqortal_noderecreation. - Use
--extauthto force external-auth profile recreation. --extauthalone now recreatesexternal_authwithout recreatingqortal_nodedependencies.
docker-qortal-restart.sh- Restarts
qortal_nodeonly (plus optional--restart-external-auth).
- Restarts
scripts/ Helpers
scripts/nextcloud-occ.sh <env-file> <occ args...>- Wrapper for running Nextcloud
occinside Docker app container.
- Wrapper for running Nextcloud
scripts/select-qortal-p2p-port.sh <env-file>- Chooses an available Qortal API host port and sets P2P to API+1 and QDN to API+3.
scripts/ensure-qortal-settings.sh- Initializes
qortal/data/settings.jsonfrom default template when missing.
- Initializes
scripts/ensure-qortal-start-args.sh- Initializes
qortal/data/start-arguments.txtwith default JVM args when missing. - Optional argument:
<env-file>to seed fromQORTAL_JVM_MEMORY_ARGS.
- Initializes
scripts/ensure-broker-internal-token.sh <env-file>- Ensures
BROKER_INTERNAL_API_TOKENexists (auto-generates when missing). - Sets
BROKER_CORS_ALLOWED_ORIGINSfromNEXTCLOUD_PUBLIC_URLwhen empty.
- Ensures
scripts/nextcloud-vm-install.sh- VM/non-container oriented installation helper.
scripts/install-production-docker.sh- Production-oriented Docker installer baseline (new).
Recommended Baseline Flows
Dev-prod no-SSL (external reverse proxy)
./start-devprod.sh./recreate-devprod.shmake logs-devprod-nossl
Dev-prod SSL (internal Caddy)
./start-devprod.sh./recreate-devprod.sh --sslmake logs-devprod
Production-oriented Docker bootstrap (new)
./scripts/install-production-docker.sh --mode nossl --with-external-auth- Validate service health and OIDC setup.
- Move secrets from templates into managed secret store as needed.