User & Organization Management

Organizations in Valohai are collaborative workspaces with shared infrastructure, projects, and security policies. As an administrator, you control who has access to what — from compute resources to data stores.

Quick Start for New Admins

Access your organization settings by clicking Hi, <name> in the top-right corner, then select Manage <organization>.

Essential Setup Checklist

Users & Teams:

• Invite users to your organization

• Create teams to organize access by project or department

• Enable two-factor authentication for security (optional)

Infrastructure & Data:

• Configure environment scaling for compute resources

• Set team quotas to control parallel machine usage

• Restrict data stores by team

• Add credentials for private Docker registries

Security & Credentials:

• Set up organization-level environment variables for shared secrets

• Configure Single Sign-On (Azure AD or Okta)

• Review the Audit Log for compliance tracking

Access Control Model

Valohai uses a three-tier hierarchy:

Organizations

Top-level entities that own:

• Compute environments (machine types)

• Data stores (S3, Azure Blob, GCS)

• Security policies (SSO, 2FA requirements)

• Billing settings

Teams

Groups of users within an organization. Teams can:

• Own projects collectively

• Share environment quotas

• Access organization data stores

• Map to SSO groups for automatic membership

Users

Individual accounts that can:

• Belong to multiple organizations and teams

• Own personal projects (if allowed by org policy)

• Have organization-level admin privileges

Common Administrative Tasks

User Management

• Invite users via email

• Create teams for department-level access

• Configure SSO to automate user provisioning

Resource Control

• Set team quotas to limit concurrent machines

• Configure environment scaling for auto-scaling behavior

• Restrict data stores to specific teams

Security & Compliance

• Manage environment variables for secrets

• Review audit logs for activity tracking

• Set up billing and payment methods

Multi-Organization Workflows

Users can belong to multiple organizations simultaneously. This enables:

• Development stages: Separate organizations for development, staging, and production.

• Departmental isolation: Different business units with independent budgets and resources.

• Consulting workflows: Work with multiple clients, each with isolated environments and data.

Switch between organizations using the dropdown in the top-right corner.

Organization Settings Overview

Key configuration options in Settings tab:

Project Policies:

• Forbid personal projects (require all projects to be org/team-owned)

• Disallow public data stores (prevent users from adding public cloud buckets)

Security:

• Require two-factor authentication for all users

• Set maximum API token lifetime

• Configure default debug ports for SSH access

Defaults:

• Default commit store (where code snapshots are saved)

• Default log store (where execution logs are archived)

Getting Help

Documentation: Browse guides in this section for detailed setup instructions.

Support: Contact [email protected] for SSO configuration, custom integrations, or infrastructure questions.

FAQ: See Frequently Asked Questions for common scenarios.

What's Next?

New to Valohai administration? Start here:

1. Invite your first users

2. Create teams for your organization structure

3. Set up environment variables for shared credentials

4. Configure team quotas to control resource usage

Already familiar with the basics? Explore advanced topics:

• Azure AD SSO — Centralize authentication

• Audit Log — Track all organizational activity

• Environment Scaling — Fine-tune auto-scaling behavior