{"record":{"id":"31e7107d0eded53a","repo":"semaphoreui/semaphore","slug":"k8s-executor-is-only-available-in-the-proprietary","errorCode":null,"errorMessage":"k8s executor is only available in the proprietary build","messagePattern":"k8s executor is only available in the proprietary build","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"pro/services/tasks/k8s/config.go","lineNumber":22,"sourceCode":"// in via the top-level go.mod replace directive (or a workspace), the same import\n// path resolves to a fully functional provider that runs each task in an ephemeral\n// Pod. In the open-source build this stub keeps the executor_factory and job_pool\n// imports compiling while making it explicit that the \"k8s\" runner executor type\n// requires the proprietary build.\n//\n// The only entry point is NewProvider; it always fails so JobPool refuses to start\n// and the operator sees a clear message in the logs.\npackage k8s\n\nimport (\n\t\"errors\"\n\n\t\"github.com/semaphoreui/semaphore/services/tasks\"\n\t\"github.com/semaphoreui/semaphore/util\"\n)\n\nfunc NewProvider(_ util.RunnerK8sConfig) (tasks.ExecutorProvider, error) {\n\treturn nil, errors.New(\"k8s executor is only available in the proprietary build\")\n}\n","sourceCodeStart":4,"sourceCodeEnd":24,"githubUrl":"https://github.com/semaphoreui/semaphore/blob/1774ccb71a0a8b82eb74ea24c23ac9ab713de2fa/pro/services/tasks/k8s/config.go#L4-L24","documentation":"In the open-source build of Semaphore, the Kubernetes executor stub always returns this error. The real K8s executor implementation is proprietary-only, so any attempt to create a Kubernetes executor provider from the OSS binary fails unconditionally.","triggerScenarios":"Calling pro/services/tasks/k8s.NewProvider (via newExecutorProvider in services/runners/executor_factory.go) when resolveExecutorType(executorCfg) resolves to util.ExecutorTypeKubernetes — i.e. runner config selects the kubernetes executor on the OSS build.","commonSituations":"Running self-hosted open-source Semaphore in a Kubernetes cluster with `executor-type: kubernetes` set, expecting in-cluster job execution that is actually gated behind the enterprise build.","solutions":["Change the runner's executor-type config to 'local', the only executor supported in the open-source build","Deploy the proprietary Semaphore build that ships the real Kubernetes executor","Confirm the running binary is actually the proprietary build if you believe you have a license"],"exampleFix":"# before (config.yml)\nexecutor-type: kubernetes\n# after (open-source build)\nexecutor-type: local","handlingStrategy":"validation","validationCode":"if resolveExecutorType(executorCfg) == util.ExecutorTypeKubernetes {\n    return errors.New(\"k8s executor requires the proprietary Semaphore build\")\n}","typeGuard":"func isOSSBuild() bool { return buildFlavor == \"oss\" }\nif isOSSBuild() && resolveExecutorType(cfg) == util.ExecutorTypeKubernetes { /* skip/reject */ }","tryCatchPattern":null,"preventionTips":["Only set executor-type: kubernetes when running the proprietary build","Validate runner configuration before starting the runner","Keep deployment docs explicit about EE-only executors"],"tags":["go","kubernetes","licensing","configuration"],"backgroundTag":"feature-not-enabled","analyzedSha":"1774ccb71a0a8b82eb74ea24c23ac9ab713de2fa","analyzedAt":"2026-09-07T11:00:33.293Z","contentChangedAt":"2026-09-07T11:00:33.293Z","schemaVersion":2},"datasetVersion":"2026-09-16T09:17:16.951Z"}