Oct 29, 2025 · Oct 29, 2025
diff --git a/cli/server.go b/cli/server.go
 Listener:      terraformServer,
 Logger:        provisionerLogger,
 WorkDirectory: workDir,
 Experiments:   coderAPI.Experiments,
 },
 CachePath: tfDir,
 Tracer:    tracer,
diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
diff --git a/coderd/coderd.go b/coderd/coderd.go
 api.NotificationsEnqueuer,
 &api.PrebuildsReconciler,
 api.ProvisionerdServerMetrics,
 api.Experiments,
 )
 if err != nil {
 return nil, err
diff --git a/coderd/provisionerdserver/provisionerdserver.go b/coderd/provisionerdserver/provisionerdserver.go
 NotificationsEnqueuer       notifications.Enqueuer
 PrebuildsOrchestrator       *atomic.Pointer[prebuilds.ReconciliationOrchestrator]
 UsageInserter               *atomic.Pointer[usage.Inserter]
 Experiments                 codersdk.Experiments

 OIDCConfig promoauth.OAuth2Config

 enqueuer notifications.Enqueuer,
 prebuildsOrchestrator *atomic.Pointer[prebuilds.ReconciliationOrchestrator],
 metrics *Metrics,
 experiments codersdk.Experiments,
 ) (proto.DRPCProvisionerDaemonServer, error) {
 // Fail-fast if pointers are nil
 if lifecycleCtx == nil {
 PrebuildsOrchestrator:       prebuildsOrchestrator,
 UsageInserter:               usageInserter,
 metrics:                     metrics,
 Experiments:                 experiments,
 }

 if s.heartbeatFn == nil {
diff --git a/coderd/provisionerdserver/provisionerdserver_test.go b/coderd/provisionerdserver/provisionerdserver_test.go
 "storj.io/drpc"

 "cdr.dev/slog/sloggers/slogtest"
 "github.com/coder/coder/v2/coderd"
 "github.com/coder/quartz"
 "github.com/coder/serpent"

 notifEnq,
 &op,
 provisionerdserver.NewMetrics(logger),
 coderd.ReadExperiments(logger, ov.deploymentValues.Experiments),
 )
 require.NoError(t, err)
 return srv, db, ps, daemon
diff --git a/codersdk/deployment.go b/codersdk/deployment.go
 ExperimentOAuth2             Experiment = "oauth2"               // Enables OAuth2 provider functionality.
 ExperimentMCPServerHTTP      Experiment = "mcp-server-http"      // Enables the MCP HTTP server functionality.
 ExperimentWorkspaceSharing   Experiment = "workspace-sharing"    // Enables updating workspace ACLs for sharing with users and groups.
 // ExperimentTerraformWorkspace is named after the "Terraform Workspaces" feature, not to be confused with Coder Workspaces.
 ExperimentTerraformWorkspace Experiment = "terraform-workspaces" // Enables reuse of existing terraform directory for builds
 )

 func (e Experiment) DisplayName() string {
 return "MCP HTTP Server Functionality"
 case ExperimentWorkspaceSharing:
 return "Workspace Sharing"
 case ExperimentTerraformWorkspace:
 return "Terraform Workspace Caching"
 default:
 // Split on hyphen and convert to title case
 // e.g. "web-push" -> "Web Push", "mcp-server-http" -> "Mcp Server Http"
diff --git a/docs/reference/api/schemas.md b/docs/reference/api/schemas.md
diff --git a/docs/reference/cli/provisioner_start.md b/docs/reference/cli/provisioner_start.md
diff --git a/enterprise/cli/provisionerdaemonstart.go b/enterprise/cli/provisionerdaemonstart.go
 "github.com/coder/coder/v2/cli/clilog"
 "github.com/coder/coder/v2/cli/cliui"
 "github.com/coder/coder/v2/cli/cliutil"
 "github.com/coder/coder/v2/coderd"
 "github.com/coder/coder/v2/coderd/database"
 "github.com/coder/coder/v2/codersdk"
 "github.com/coder/coder/v2/codersdk/drpcsdk"
 preSharedKey   string
 provisionerKey string
 verbose        bool
 experiments    []string

 prometheusEnable  bool
 prometheusAddress string
 Listener:      terraformServer,
 Logger:        logger.Named("terraform"),
 WorkDirectory: tempDir,
 Experiments:   coderd.ReadExperiments(logger, experiments),
 },
 CachePath: cacheDir,
 })
 Value:       serpent.StringOf(&prometheusAddress),
 Default:     "127.0.0.1:2112",
 },
 {
 Name:        "Experiments",
 Description: "Enable one or more experiments. These are not ready for production. Separate multiple experiments with commas, or enter '*' to opt-in to all available experiments.",
 Flag:        "experiments",
 Env:         "CODER_EXPERIMENTS",
 Value:       serpent.StringArrayOf(&experiments),
 YAML:        "experiments",
 },
 }
 orgContext.AttachOptions(cmd)

diff --git a/enterprise/cli/testdata/coder_provisioner_start_--help.golden b/enterprise/cli/testdata/coder_provisioner_start_--help.golden
  Run a provisioner daemon

 OPTIONS:
      --experiments string-array, $CODER_EXPERIMENTS
          Enable one or more experiments. These are not ready for production.
          Separate multiple experiments with commas, or enter '*' to opt-in to
          all available experiments.

  -O, --org string, $CODER_ORGANIZATION
          Select which organization (uuid or name) to use.

diff --git a/enterprise/coderd/coderdenttest/coderdenttest.go b/enterprise/coderd/coderdenttest/coderdenttest.go
 ServeOptions: &provisionersdk.ServeOptions{
 Listener:      provisionerSrv,
 WorkDirectory: t.TempDir(),
 Experiments:   codersdk.Experiments{},
 },
 }))
 }()
diff --git a/enterprise/coderd/provisionerdaemons.go b/enterprise/coderd/provisionerdaemons.go
 api.NotificationsEnqueuer,
 &api.AGPL.PrebuildsReconciler,
 api.ProvisionerdServerMetrics,
 api.AGPL.Experiments,
 )
 if err != nil {
 if !xerrors.Is(err, context.Canceled) {
diff --git a/provisionersdk/serve.go b/provisionersdk/serve.go
 "storj.io/drpc/drpcserver"

 "cdr.dev/slog"
 "github.com/coder/coder/v2/codersdk"
 "github.com/coder/coder/v2/codersdk/drpcsdk"

 "github.com/coder/coder/v2/coderd/tracing"
 Logger              slog.Logger
 WorkDirectory       string
 ExternalProvisioner bool
 Experiments         codersdk.Experiments
 }

 type Server interface {
diff --git a/provisionersdk/session.go b/provisionersdk/session.go
 s.logLevel = proto.LogLevel_value[strings.ToUpper(s.Config.ProvisionerLogLevel)]
 }

 // Extract the template source archive into the work directory.
 err = s.Files.ExtractArchive(s.Context(), s.Logger, afero.NewOsFs(), s.Config)
 if err != nil {
 return xerrors.Errorf("extract archive: %w", err)
 }

 // Handle requests, which will amount to terraform cli execs.
 return s.handleRequests()
 }

diff --git a/site/src/api/typesGenerated.ts b/site/src/api/typesGenerated.ts
Original file line number	Diff line number	Diff line change
Expand Up		@@ -1476,6 +1476,7 @@ func newProvisionerDaemon(
		Listener: terraformServer,
		Logger: provisionerLogger,
		WorkDirectory: workDir,
		Experiments: coderAPI.Experiments,
		},
		CachePath: tfDir,
		Tracer: tracer,
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -1999,6 +1999,7 @@ func (api *API) CreateInMemoryTaggedProvisionerDaemon(dialCtx context.Context, n
		api.NotificationsEnqueuer,
		&api.PrebuildsReconciler,
		api.ProvisionerdServerMetrics,
		api.Experiments,
		)
		if err != nil {
		return nil, err
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -120,6 +120,7 @@ type server struct {
		NotificationsEnqueuer notifications.Enqueuer
		PrebuildsOrchestrator *atomic.Pointer[prebuilds.ReconciliationOrchestrator]
		UsageInserter *atomic.Pointer[usage.Inserter]
		Experiments codersdk.Experiments

		OIDCConfig promoauth.OAuth2Config

Expand DownExpand Up		@@ -181,6 +182,7 @@ func NewServer(
		enqueuer notifications.Enqueuer,
		prebuildsOrchestrator *atomic.Pointer[prebuilds.ReconciliationOrchestrator],
		metrics *Metrics,
		experiments codersdk.Experiments,
		) (proto.DRPCProvisionerDaemonServer, error) {
		// Fail-fast if pointers are nil
		if lifecycleCtx == nil {
Expand DownExpand Up		@@ -252,6 +254,7 @@ func NewServer(
		PrebuildsOrchestrator: prebuildsOrchestrator,
		UsageInserter: usageInserter,
		metrics: metrics,
		Experiments: experiments,
		}

		if s.heartbeatFn == nil {
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -26,6 +26,7 @@ import (
		"storj.io/drpc"

		"cdr.dev/slog/sloggers/slogtest"
		"github.com/coder/coder/v2/coderd"
		"github.com/coder/quartz"
		"github.com/coder/serpent"

Expand DownExpand Up		@@ -4251,6 +4252,7 @@ func setup(t testing.T, ignoreLogErrors bool, ov overrides) (proto.DRPCProvisi
		notifEnq,
		&op,
		provisionerdserver.NewMetrics(logger),
		coderd.ReadExperiments(logger, ov.deploymentValues.Experiments),
		)
		require.NoError(t, err)
		return srv, db, ps, daemon
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -3635,6 +3635,8 @@ const (
		ExperimentOAuth2 Experiment = "oauth2" // Enables OAuth2 provider functionality.
		ExperimentMCPServerHTTP Experiment = "mcp-server-http" // Enables the MCP HTTP server functionality.
		ExperimentWorkspaceSharing Experiment = "workspace-sharing" // Enables updating workspace ACLs for sharing with users and groups.
		// ExperimentTerraformWorkspace is named after the "Terraform Workspaces" feature, not to be confused with Coder Workspaces.
		ExperimentTerraformWorkspace Experiment = "terraform-workspaces" // Enables reuse of existing terraform directory for builds
		)

		func (e Experiment) DisplayName() string {
Expand All		@@ -3655,6 +3657,8 @@ func (e Experiment) DisplayName() string {
		return "MCP HTTP Server Functionality"
		case ExperimentWorkspaceSharing:
		return "Workspace Sharing"
		case ExperimentTerraformWorkspace:
		return "Terraform Workspace Caching"
		default:
		// Split on hyphen and convert to title case
		// e.g. "web-push" -> "Web Push", "mcp-server-http" -> "Mcp Server Http"
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -23,6 +23,7 @@ import (
		"github.com/coder/coder/v2/cli/clilog"
		"github.com/coder/coder/v2/cli/cliui"
		"github.com/coder/coder/v2/cli/cliutil"
		"github.com/coder/coder/v2/coderd"
		"github.com/coder/coder/v2/coderd/database"
		"github.com/coder/coder/v2/codersdk"
		"github.com/coder/coder/v2/codersdk/drpcsdk"
Expand All		@@ -48,6 +49,7 @@ func (r RootCmd) provisionerDaemonStart() serpent.Command {
		preSharedKey string
		provisionerKey string
		verbose bool
		experiments []string

		prometheusEnable bool
		prometheusAddress string
Expand DownExpand Up		@@ -186,6 +188,7 @@ func (r RootCmd) provisionerDaemonStart() serpent.Command {
		Listener: terraformServer,
		Logger: logger.Named("terraform"),
		WorkDirectory: tempDir,
		Experiments: coderd.ReadExperiments(logger, experiments),
		},
		CachePath: cacheDir,
		})
Expand DownExpand Up		@@ -378,6 +381,14 @@ func (r RootCmd) provisionerDaemonStart() serpent.Command {
		Value: serpent.StringOf(&prometheusAddress),
		Default: "127.0.0.1:2112",
		},
		{
		Name: "Experiments",
		Description: "Enable one or more experiments. These are not ready for production. Separate multiple experiments with commas, or enter '*' to opt-in to all available experiments.",
		Flag: "experiments",
		Env: "CODER_EXPERIMENTS",
		Value: serpent.StringArrayOf(&experiments),
		YAML: "experiments",
		},
		}
		orgContext.AttachOptions(cmd)

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,6 +6,11 @@ USAGE:
		Run a provisioner daemon

		OPTIONS:
		--experiments string-array, $CODER_EXPERIMENTS
		Enable one or more experiments. These are not ready for production.
		Separate multiple experiments with commas, or enter '*' to opt-in to
		all available experiments.

		-O, --org string, $CODER_ORGANIZATION
		Select which organization (uuid or name) to use.

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -414,6 +414,7 @@ func newExternalProvisionerDaemon(t testing.TB, client *codersdk.Client, org uui
		ServeOptions: &provisionersdk.ServeOptions{
		Listener: provisionerSrv,
		WorkDirectory: t.TempDir(),
		Experiments: codersdk.Experiments{},
		},
		}))
		}()
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -362,6 +362,7 @@ func (api API) provisionerDaemonServe(rw http.ResponseWriter, r http.Request)
		api.NotificationsEnqueuer,
		&api.AGPL.PrebuildsReconciler,
		api.ProvisionerdServerMetrics,
		api.AGPL.Experiments,
		)
		if err != nil {
		if !xerrors.Is(err, context.Canceled) {
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -15,6 +15,7 @@ import (
		"storj.io/drpc/drpcserver"

		"cdr.dev/slog"
		"github.com/coder/coder/v2/codersdk"
		"github.com/coder/coder/v2/codersdk/drpcsdk"

		"github.com/coder/coder/v2/coderd/tracing"
Expand All		@@ -30,6 +31,7 @@ type ServeOptions struct {
		Logger slog.Logger
		WorkDirectory string
		ExternalProvisioner bool
		Experiments codersdk.Experiments
		}

		type Server interface {
Expand Down