Sanitized single-commit public mirror of recipe-maintainer. - Removed test-ssh/.testenv (live creds); added test-ssh/.testenv.example placeholders. - Removed plans/ and planned-updates/ (deployment-planning docs) so no client/ deployment domains appear in the public repo. - All other secret stores were already gitignored. - docs.coopcloud.tech retained as a submodule (public upstream).
1.2 KiB
1.2 KiB
La Suite Docs — First-Time Setup
Prerequisites
- DNS:
lasuite-docs.<domain_suffix>must resolve to the server - Keycloak must be deployed and running (dependency)
Steps
-
Create the app:
abra app new lasuite-docs --server <SERVER> --domain lasuite-docs.<DOMAIN_SUFFIX> --no-input -
Generate secrets:
abra app secret generate lasuite-docs.<DOMAIN_SUFFIX> --all -m --no-inputSave output to
recipe-info/testsecrets/lasuite-docs.<DOMAIN_SUFFIX>. -
Deploy:
abra app deploy lasuite-docs.<DOMAIN_SUFFIX> --chaos --force --no-input -
Keycloak SSO integration:
python3 recipe-info/lasuite-docs/setup_keycloak_integration.pyThis creates a
lasuite-docsrealm, OIDC client, and test user in Keycloak. It also inserts the client secret and updates the env file. -
Redeploy with SSO config:
abra app deploy lasuite-docs.<DOMAIN_SUFFIX> --chaos --force --no-input -
Verify: curl
https://lasuite-docs.<DOMAIN_SUFFIX>returns HTTP 200.
Notes
- Credentials are saved to
recipe-info/lasuite-docs/keycloak-test-credentials.<DOMAIN_SUFFIX>.toml. - OIDC test user:
testuser/testpass123.