Files
recipe-maintainer/recipe-info/lasuite-docs/setup.md
autonomic-bot f283a371bb recipe-maintainer: public snapshot (secrets + deployment plans removed, single commit)
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).
2026-06-16 20:18:24 +00:00

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

  1. Create the app:

    abra app new lasuite-docs --server <SERVER> --domain lasuite-docs.<DOMAIN_SUFFIX> --no-input
    
  2. Generate secrets:

    abra app secret generate lasuite-docs.<DOMAIN_SUFFIX> --all -m --no-input
    

    Save output to recipe-info/testsecrets/lasuite-docs.<DOMAIN_SUFFIX>.

  3. Deploy:

    abra app deploy lasuite-docs.<DOMAIN_SUFFIX> --chaos --force --no-input
    
  4. Keycloak SSO integration:

    python3 recipe-info/lasuite-docs/setup_keycloak_integration.py
    

    This creates a lasuite-docs realm, OIDC client, and test user in Keycloak. It also inserts the client secret and updates the env file.

  5. Redeploy with SSO config:

    abra app deploy lasuite-docs.<DOMAIN_SUFFIX> --chaos --force --no-input
    
  6. 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.