Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions enterprise/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,7 @@
| `app.<your-domain>` | `app.openhands.example.com` |
| `auth.app.<your-domain>` | `auth.app.openhands.example.com` |
| `llm-proxy.<your-domain>` | `llm-proxy.openhands.example.com` |
| `analytics.<your-domain>` | `analytics.openhands.example.com` |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Suggestion: Consider placing analytics.<your-domain> before llm-proxy.<your-domain> for alphabetical consistency:

Suggested change
| `analytics.<your-domain>` | `analytics.openhands.example.com` |
| `analytics.<your-domain>` | `analytics.openhands.example.com` |
| `llm-proxy.<your-domain>` | `llm-proxy.openhands.example.com` |

Alternatively, if there's a logical grouping reason (deployment order, functional grouping, etc.), that's fine too. This is a minor style preference.

| `runtime-api.<your-domain>` | `runtime-api.openhands.example.com` |
| `*.runtime.<your-domain>` | `*.runtime.openhands.example.com` |

Expand Down Expand Up @@ -167,15 +168,16 @@
"app.${BASE_DOMAIN}" \
"auth.app.${BASE_DOMAIN}" \
"llm-proxy.${BASE_DOMAIN}" \
"analytics.${BASE_DOMAIN}" \
"runtime-api.${BASE_DOMAIN}"; do
echo "[DNS] $h"
getent hosts "$h" || nslookup "$h"
done
```

Expected: each hostname above resolves to your VM's public IP address.

Check warning on line 178 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L178

Did you really mean 'hostname'?

Check warning on line 178 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L178

Did you really mean 'VM's'?

Test that a runtime wildcard hostname resolves:

Check warning on line 180 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L180

Did you really mean 'hostname'?

```bash
getent hosts "test.runtime.${BASE_DOMAIN}" || nslookup "test.runtime.${BASE_DOMAIN}"
Expand Down Expand Up @@ -210,7 +212,7 @@
done
```

Any HTTP response code other than `000` is acceptable for reachability checks

Check warning on line 215 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L215

Did you really mean 'reachability'?
(for example `200`, `301`, `302`, `401`, `403`, `405`).

If any check fails, stop and resolve before continuing:
Expand All @@ -221,10 +223,10 @@

| Requirement | Why It Exists |
|------------|----------------|
| `443/TCP` inbound | Primary HTTPS entrypoint for users and service hostnames |

Check warning on line 226 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L226

Did you really mean 'hostnames'?
| `30000/TCP` inbound | Replicated/KOTS Admin Console for install and configuration |
| `80/TCP` inbound | HTTP entrypoint used for ingress/redirect behavior |
| `*.runtime.<domain>` DNS + cert SAN | Runtime sandboxes are addressed by dynamic runtime-specific hostnames |

Check warning on line 229 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L229

Did you really mean 'hostnames'?
| `replicated.app`, `proxy.replicated.com` | Replicated control-plane/license/install paths |
| `images.r9...`, `charts.r9...`, `updates.r9...`, `install.r9...` | Vendor distribution image/chart/update/install endpoints |
| `traefik.github.io` | Embedded cluster ingress chart repository |
Expand Down Expand Up @@ -290,7 +292,7 @@
### 5. Upload TLS certificate (if not provided with the install command)

If you did not provide certificates with the `install` command, select **"Upload your own"**,
enter your base domain under **Hostname**, upload your private key and SSL certificate, then click **Continue**.

Check warning on line 295 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L295

Did you really mean 'Hostname'?

![Upload TLS certificate](./images/upload-tls-certificate.png)

Expand All @@ -315,7 +317,7 @@

### Domain Configuration

- Select **"Derive hostnames from domain (recommended)"**

Check warning on line 320 in enterprise/quick-start.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

enterprise/quick-start.mdx#L320

Did you really mean 'hostnames'?
- Enter your base domain (e.g., `openhands.example.com`)

### Certificate Configuration
Expand Down
Loading