Skip to main content

Troubleshooting

Find solutions to common issues when running Expanso Edge.

Quick Diagnostic Commands

# Check node status
expanso-cli node list

# Check job status
expanso-cli job list

# View execution details
expanso-cli execution list --state failed
expanso-cli execution list --state degraded

# Check job logs
expanso-cli job logs <job-id>

# Check edge process status
systemctl status expanso-edge

Common Issues

IssueTypical Symptoms
Permission Denied After BootstrapCan't write to /var/lib/expanso/edge or similar directories
Job Shows Failed But CompletedJob status shows "failed" but logs show successful completion
Pipeline Progress Lost After RestartPipeline restarts from the beginning after edge process restart
One-Shot Jobs Restart UnexpectedlyBatch jobs run again after edge restart when they shouldn't
Restart Events Not TrackedRestarts don't show up in failure metrics or logs
Pipeline Stuck in Failed State409 CONFLICT errors when trying to redeploy a failed pipeline
Pipeline Stuck in Degraded StatePipeline can't recover from degraded state automatically
Nodes Show Connected After RestartNodes appear connected but jobs don't start after orchestrator restart

Next Steps