Rack
Overview of rack metadata (provider, region, version, status).
Web UI Overview
The Rack Gateway web UI is the primary way to inspect rack state, manage users, review audit logs, and configure gateway settings.
Accessing the Web UI
Section titled “Accessing the Web UI”From the CLI
Section titled “From the CLI”rack-gateway webDirect URL
Section titled “Direct URL”https://gateway.example.comYou’ll be redirected to Google OAuth if you aren’t signed in.
Main Sections
Section titled “Main Sections”Apps
Browse apps and app-specific settings.
API Tokens
Manage automation tokens and permissions.
Audit Logs
Review and export activity history.
Account Security
Manage MFA methods, backup codes, and trusted devices.
Settings
Configure gateway-wide security controls (admins only).
Navigation Overview
Section titled “Navigation Overview”The sidebar contains these sections (some are admin-only):
| Section | Description | Access |
|---|---|---|
| Rack | Rack metadata and status | All users |
| Apps / Processes / Instances / Builds / Releases | Convox operational views | Role-based |
| Users | User list and details | All users (admin actions only) |
| API Tokens | Token list and management | All users (create/edit requires Admin or Deployer) |
| Deploy Approvals | Pending approvals | Admin only |
| Audit Logs | Audit trail and export | All users (read-only) |
| Account Security | MFA + trusted devices | All users |
| Integrations | Slack, GitHub, CircleCI | Admin only |
| Settings | Global security settings | Admin only |
| Background Jobs | Job queue visibility | Admin only |
| Configure CLI | Quick CLI setup dialog | All users |
App Settings
Section titled “App Settings”App-level settings live under Apps → {app} → Settings. This is where admins configure:
- VCS/CI integration per app (GitHub + CircleCI)
- Protected and secret environment variables
- Approved deploy commands
- Service image patterns used for deploy verification
Signing Out
Section titled “Signing Out”Use the Logout button at the bottom of the sidebar.
Next Steps
Section titled “Next Steps”- Rack Overview - Rack landing page
- User Management - Users and roles
- API Tokens - Token management
- Audit Logs - Compliance history
- Settings - Global configuration