Skip to main content
Connect your HashiCorp Consul instances to manage service discovery and configuration through ShiftLabs.

​
How to Add a Consul Instance

1

Open Integrations

Go to Settings → Integrations → Consul tab.
2

Click Add Consul

Click the Add Consul button.
3

Enter Connection Details

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

Save

Click Create. Use the health check to verify connectivity.

​
How to Edit a Consul 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.

​
How to Delete a Consul Instance

  1. Click the delete icon on the instance row
  2. Confirm the deletion
Deleting a Consul instance removes the connection. Services registered in Consul are not affected.

​
Troubleshooting

  1. Verify the host URL is correct
  2. Check if the ACL token is valid
  3. Ensure Consul is running and accessible
  4. If using self-signed certificates, disable SSL verification
The ACL token may not have sufficient permissions. Verify the token’s policy allows read access.

​
FAQ

Yes. Add instances for different datacenters or environments.
The token needs read access to services, intentions, and key/value store you want to manage.