Skip to main content
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

​
Examples

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 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. The egress profile defaults to interactive for a trusted developer. It permits the broader provider access needed for a human-driven session and is not a confidentiality boundary. The platform controller must select --egress-profile managed and supply its provisioned Private Service Connect model-gateway URL as a literal IPv4 http:// or https:// URL. Managed runs block DNS and IPv6 and allow TCP only to that exact address and port. Never combine a managed Task Agent with --compose-access or --skip-egress-firewall.

​
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 and records the selected component disposition and settings in .libops/site.yaml. Use sitectl validate to confirm the result. Use sitectl converge --report to inspect later manual edits or upstream changes against that durable intent before applying a repair.