What's Actually Happening

Boundary cannot establish connections to targets. Users cannot access infrastructure resources through Boundary.

The Error You'll See

```bash $ boundary connect ssh -target-id ttcp_xxx

Error: error creating session: target not found or unreachable ```

Why This Happens

  1. 1.Worker not running
  2. 2.Target misconfigured
  3. 3.Network connectivity
  4. 4.Host catalog issues
  5. 5.Credential problems

Step 1: Check Worker Status

bash
boundary workers list
boundary workers read -id w_xxx

Step 2: Check Target Configuration

bash
boundary targets read -id ttcp_xxx
boundary targets list -host-catalog-id hc_xxx

Step 3: Check Host Catalog

bash
boundary host-catalogs read -id hc_xxx
boundary hosts list -host-catalog-id hc_xxx

Step 4: Check Host Sets

bash
boundary host-sets list -host-catalog-id hc_xxx
boundary host-sets read -id hs_xxx

Step 5: Check Network Connectivity

bash
# From worker to target:
ping target-host
nc -zv target-host 22

Step 6: Check Boundary Logs

bash
journalctl -u boundary -f
docker logs boundary

Step 7: Verify Worker Tags

bash
# Worker tags must match target worker_filter
boundary workers read -id w_xxx

Step 8: Check Credential Libraries

bash
boundary credential-libraries list -credential-store-id cs_xxx

Step 9: Restart Boundary

bash
systemctl restart boundary
docker restart boundary

Step 10: Test Connection

bash
boundary connect ssh -target-id ttcp_xxx -exec ssh -- -l username
  • [Fix Boundary Session Failed](/articles/fix-boundary-session-failed)
  • [Fix Vault Token Renewal Failed](/articles/fix-vault-token-renewal-failed)