Skip to Content
HeadGym
User GuideMars AdminConfiguration Profiles
Tags:#config-profiles#configuration#templates#resources

Configuration Profiles

Config Profiles define resource limits, environment variables, and security settings for clusters and instances.

Overview

The Config Profiles page allows you to create, manage, and apply configuration templates to your clusters and instances.

Profile Properties

PropertyDescription
NameUnique identifier for the profile
VersionVersion number of the profile
TargetWhat the profile applies to (cluster, instance, or both)
UsageNumber of clusters using this profile
ModifiedLast modification date
DescriptionBrief description of the profile

Profile Configuration

Resources

Define compute resource limits:

  • CPU - Number of CPU cores (e.g., 2, 4, 0.5)
  • Memory - Memory allocation (e.g., 4Gi, 8Gi, 1Gi)

Environment Variables

Set environment variables that will be available to instances:

  • Key-value pairs
  • Example: RUNTIME_MODE=prod, LOG_LEVEL=info

Security Settings

Configure security policies:

  • Run as non-root - Whether instances must run as non-root user
  • Allow privilege escalation - Whether processes can gain additional privileges

Target Types

TypeDescription
ClusterProfile applies to cluster-level settings
InstanceProfile applies to individual instances
Cluster + InstanceProfile applies to both levels

Managing Profiles

Creating a Profile

  1. Click the Create Profile button
  2. Enter profile name and description
  3. Set CPU and memory limits
  4. Select target type
  5. Configure security settings
  6. Add environment variables (optional)
  7. Click “Create Profile”

Viewing Details

Click on any profile to see:

  • Full configuration details
  • Resource limits
  • Environment variables
  • Security settings

Editing Profiles

  1. Click Edit on the profile
  2. Modify desired settings
  3. Click “Save Changes”

Duplicating Profiles

Click Duplicate to create a copy of an existing profile as a starting point for a new one.

Built-in Profiles

The platform includes several default profiles:

  • default-v3 - Standard production configuration with balanced resources
  • latency-optimized - Low-latency configuration for real-time workloads
  • staging-v2 - Staging configuration with debug logging
  • edge-v1 - Lightweight configuration for edge deployments

Applying Profiles

To apply a config profile to a cluster:

  1. Go to the Clusters page
  2. Click Apply on the target cluster
  3. Select the desired profile
  4. Confirm the application

Best Practices

  • Use descriptive names that indicate the profile’s purpose
  • Version your profiles for change tracking
  • Test profiles in non-production environments first
  • Document the purpose of each profile
  • Review resource limits regularly based on actual usage
Last updated on