# 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:**
   ```bash
   abra app new lasuite-docs --server <SERVER> --domain lasuite-docs.<DOMAIN_SUFFIX> --no-input
   ```

2. **Generate secrets:**
   ```bash
   abra app secret generate lasuite-docs.<DOMAIN_SUFFIX> --all -m --no-input
   ```
   Save output to `recipe-info/testsecrets/lasuite-docs.<DOMAIN_SUFFIX>`.

3. **Deploy:**
   ```bash
   abra app deploy lasuite-docs.<DOMAIN_SUFFIX> --chaos --force --no-input
   ```

4. **Keycloak SSO integration:**
   ```bash
   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:**
   ```bash
   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`.