Skip to main content
Connect your ArgoCD instances to manage GitOps deployments through ShiftLabs.

How to Add an ArgoCD Instance

1

Open Integrations

Go to Settings → Integrations → ArgoCD tab.
2

Click Add ArgoCD

Click the Add ArgoCD button.
3

Enter Connection Details

  • Name (required): Display name for this instance
  • Host (required): ArgoCD server URL (e.g., https://argocd.example.com)
  • Token (required): ArgoCD API token for authentication
  • Verify SSL: Enable to validate SSL certificates
  • Set as Default: Make this the default ArgoCD instance
4

Save

Click Create. Use the health check to verify connectivity.

How to Edit an ArgoCD Instance

  1. Click the edit icon on the instance row
  2. Modify the settings
  3. Click Save
Leave the token field empty when editing to keep the existing token.

How to Check Health

Click the Check button on any instance to verify connectivity. A successful check confirms ShiftLabs can communicate with ArgoCD.

How to Delete an ArgoCD Instance

  1. Click the delete icon on the instance row
  2. Confirm the deletion
Deleting an ArgoCD instance removes the connection. Existing ArgoCD applications are not affected.

Troubleshooting

  1. Verify the host URL is correct (include https://)
  2. Check if the API token is valid and not expired
  3. Ensure ArgoCD is running and accessible from ShiftLabs
  4. If using self-signed certificates, disable SSL verification
Generate a new API token in ArgoCD:
  1. Log in to ArgoCD UI
  2. Go to Settings → Accounts
  3. Generate a new token
  4. Update the integration with the new token

FAQ

Yes. Add as many instances as needed and mark one as default.
The token should have permissions to list/view applications, projects, and clusters in ArgoCD.