Integrate with Alpacon
Connect Alpacon with your existing tools and workflows for seamless automation.
Identity providers
CI/CD platforms
GitHub Actions is our official integration, with four published actions. Every other CI system drives Alpacon through the CLI and the REST API with scoped service tokens—the guides below show how.
GitHub Actions
Automate deployments with the official Alpacon actions.
GitLab CI
Run Alpacon from GitLab CI/CD using the CLI container.
Jenkins
Run Alpacon from a Jenkins pipeline using the CLI container.
AI agents
Common integration patterns
Deployment automation
# Deploy to production server
alpacon websh production "cd /app && git pull && npm install && pm2 restart"
Multi-server commands
# Update all web servers
for server in web1 web2 web3; do
alpacon websh $server "sudo systemctl restart nginx"
done
API-based automation
# Execute commands via REST API
curl -X POST https://your-workspace.us1.alpacon.io/api/events/commands/ \
-H "Authorization: token=\"alpst-xxxxxxxxxxxxxxxxxx\"" \
-H "Content-Type: application/json" \
-d '{"server": "7e3984de-49ab-4cc6-bcdf-21fbd35858b8", "line": "deploy", "username": "ubuntu"}'
Benefits of integration
- No SSH keys in CI/CD - Use scoped service tokens instead
- Audit trail - All automated actions are logged
- Command ACLs - Restrict what automation can execute
- Simple setup - One-line installation, immediate use
Getting started
- Create a service token for automation
- Choose your integration platform above
- Follow the platform-specific guide
- Test with simple commands first
Need help?
- API reference - Complete API documentation
- CLI reference - All CLI commands
- Troubleshooting - Common integration issues