> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocklight.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and solutions

Common issues and solutions:

## Rules not loading

```bash theme={null}
# Validate rules syntax
./blocklight validate --rules rules/

# Check core logs
docker-compose logs blocklight-core | grep -i "error\|warn"
```

## No detections appearing

* Verify rules are `enabled: true`
* Test with `./blocklight dry-run --tx 0x...`
* Check blockchain connection in logs
* Ensure WebSocket URL is accessible

## Alerts not being sent

```bash theme={null}
# Check alert configuration
./blocklight config check

# Test webhook manually
curl -X POST YOUR_SLACK_WEBHOOK \
  -H 'Content-Type: application/json' \
  -d '{"text":"Test alert"}'
```

## High memory/CPU usage

* Increase cache TTL for contracts
* Reduce number of enabled rules
* Check for infinite loops in rule conditions
* Simplify complex rule conditions

## Docker build failures

```bash theme={null}
# Sync Go dependencies
cd api && go mod tidy
cd ../core && go mod tidy

# Rebuild images
docker-compose build --no-cache
```

**Need more help?** Check [GitHub Issues](https://github.com/blocklightsec/blocklight) or the [Getting Started](/getting-started) guide.