Configuration
Enterprise configuration is the user-visible layer of telling a Caracal runtime or workspace how to participate in an enterprise-managed environment.
Audience: Enterprise operators and administrators
Configuration Goals
Enterprise configuration typically answers four questions:
- which enterprise environment should this runtime or workspace connect to
- which organization context does it belong to
- what connected behavior is enabled for this environment
- how should operators safely return to local-only behavior if the enterprise connection is removed
Common Configuration Areas
Connection details
Every connected environment needs approved enterprise connection details. These define where the runtime connects and which enterprise-managed environment it joins.
Workspace linkage
Connected environments should map cleanly to the organization and workspace boundaries your team expects. Review that mapping before broader rollout.
Sync and connected behavior
Enterprise-connected environments may participate in status synchronization, shared management workflows, or enterprise-governed provider behavior. Keep those settings aligned with your operating model.
Safe local fallback
If an environment must return to open-source-only operation, disconnect it intentionally and confirm that enterprise-managed behavior is no longer assumed.
Configuration Practices
- Use organization-approved values for enterprise endpoints and connection details.
- Keep configuration consistent across environments that should behave the same way.
- Document who owns configuration changes for each workspace.
- Re-check configuration after environment moves, access changes, or major upgrades.
When To Review Configuration
Review enterprise configuration when:
- connecting a new workspace
- rotating credentials or access details
- changing ownership or organization context
- enabling or disabling connected enterprise behavior