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.

  • 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