> ## Documentation Index
> Fetch the complete documentation index at: https://sitectl.libops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# set

> Enable, disable, or reconfigure a component.

Use `set` to change a component's state or disposition. A successful command updates the component-owned project files immediately; review and commit those changes in your template fork.

## Reference

Set the state or disposition of a named component for the active context.

The component name may be prefixed with the plugin namespace:

sitectl set isle/fcrepo off
sitectl set blazegraph disabled

This command dispatches to the plugin associated with the active context.
All flags and arguments are forwarded to the plugin's set handler.

Examples:
sitectl set fcrepo off
sitectl set isle/fcrepo disabled
sitectl set iiif triplet

```bash theme={null}
sitectl set <component> [disposition] [flags]
```

## Examples

```bash theme={null}
# Disable the fcrepo component
sitectl set fcrepo off

# Enable blazegraph using its full namespace
sitectl set isle/blazegraph on

# Move IIIF image delivery to Triplet
sitectl set iiif triplet

# Keep the default local HTTP ingress
sitectl set ingress enabled --mode http --domain localhost

# Publish the site behind Cloudflare with an Origin CA cert in certs/
sitectl set ingress enabled --mode https --domain app.example.org

# Publish the site with Let's Encrypt
sitectl set ingress enabled --mode https-letsencrypt --domain app.example.org --acme-email ops@example.org

# Publish the site with your own certs/cert.pem and certs/privkey.pem
sitectl set ingress enabled --mode https-custom --domain app.example.org

# Use mkcert for a development context
sitectl set ingress enabled --mode https-mkcert --domain app.localhost

# Enable local bind mounts and add a Codex cli-sandbox service
sitectl set dev-mode --assistant --harness codex

# Let the assistant inspect the running Compose stack and Docker daemon
sitectl set dev-mode enabled --assistant --harness claude --compose-access
```

Ingress settings such as TLS mode, domain, ACME email, trusted proxy IPs, upload size, and read timeout are component settings. New stacks default to `http://localhost`. See [Ingress runtime tuning](/components#ingress-runtime-tuning) before applying upload values; backend coverage differs for PHP/nginx applications and ArchivesSpace.

`dev-mode --assistant` writes a `cli-sandbox` service into `docker-compose.override.yml` with the plugin's editable code mounts. The service is on the `assistant` profile, so start it explicitly with Docker Compose when you want an interactive coding agent.

## Namespacing

The component argument may include a plugin prefix (`plugin/component`). This is useful when multiple plugins define components with the same name, or when targeting a component owned by a specific plugin regardless of the active context.

## After setting

Running `set` modifies the relevant project files after any required confirmation. Use `sitectl validate` to confirm the result. Use `sitectl converge` only when later manual edits or upstream changes have caused drift.