Skip to main content
Credentials are the foundation of your AgentSystems configuration. They provide access to AI providers and container registries.
Credentials are stored as environment variables. The system design separates credentials from agent containers.

Managing Credentials via UI

Navigate to Configuration → Credentials in the AgentSystems UI at http://localhost:3001. The UI allows you to:
  • Add new credentials
  • Update existing credentials
  • Remove unused credentials
Changes made in the UI are written to the .env file in your deployment directory.

Manual Configuration

If editing the .env file directly:
  1. Open .env in your deployment directory
  2. Add credentials as key=value pairs
  3. Save the file
  4. Restart the platform: agentsystems restart

Credential Usage

Credentials are used by:
  • Model Connections: Reference credentials via environment variable names
  • Registry Connections: Authenticate to pull agent images
  • Agents: Credentials are managed by the platform at runtime
I