Skip to main content
Version: Weekly Build

Workspace and Hosting Plans

Plans define the resources available for developer workspaces. Configure this under the codesphere.plans section in your config.yaml.

note

Plans only define resource limits. Underprovisioning can be configured separately in the Codesphere config.yaml for the workload-provisioning component or backend. See Workload underprovisioning.

  • hostingPlans: Defines raw resource allocations. IDs must be numbers.
    • cpuTenth: CPU cores in tenths (e.g., 10 = 1 core, 25 = 2.5 cores).
    • gpuParts: GPU allocation (specific to your GPU setup).
    • memoryMb: Memory in Megabytes.
    • storageMb: Persistent storage for the workspace in Megabytes.
    • tempStorageMb: Ephemeral storage in Megabytes.
    • pooledInstances: Number of pre-warmed instances of this plan to keep ready.
  • workspacePlans: Defines user-selectable plans, mapping to hostingPlans. IDs must be numbers.
    • name: Display name of the plan.
    • hostingPlanId: Links to an ID in hostingPlans.
    • maxReplicas: Maximum number of concurrent instances for a single workspace on this plan.
    • onDemand: true if users can start/stop these workspaces, false for always-on.

Example:

codesphere:
  # ... other codesphere settings ...
  plans:
    hostingPlans:
      1:
        cpuTenth: 10
        gpuParts: 0
        memoryMb: 2048
        storageMb: 20480
        tempStorageMb: 1024
      2:
        cpuTenth: 20
        memoryMb: 4096
        storageMb: 51200
        tempStorageMb: 2048
    workspacePlans:
      1:
        name: "Basic"
        hostingPlanId: 1
        maxReplicas: 1
        onDemand: true
      2:
        name: "Pro"
        hostingPlanId: 2
        maxReplicas: 3
        onDemand: true