How trailofbits/algo works
Algo VPN is an Ansible-based deployment tool for creating a personal WireGuard and IPsec VPN server. The principal workflow is to configure users and options, launch deployment, provision a supported cloud or Ubuntu host, configure VPN and optional server services, and generate client credentials and profiles. The graph preserves the documented provider, DNS, SSH-tunneling, privacy, and user-management capabilities. Most playbooks and roles were not sampled, so deployment links beyond README statements are marked unverified rather than asserted as inspected calls.
Main entry points: playbooks Cloud setup playbooks · server.yml VPN server configuration · main.yml Ansible deployment · tasks/main.yml WireGuard setup
Components 23
Deployment
- Deployment launcher
algo - Deployment configuration
config.cfg - Ansible deployment
main.yml - Cloud setup playbooks
playbooks
Cloud providers
- DigitalOcean provisioning
roles/cloud-digitalocean/tasks/main.yml - EC2 provisioning
roles/cloud-ec2/tasks/main.yml - Lightsail provisioning
roles/cloud-lightsail/tasks/main.yml - Azure provisioning
roles/cloud-azure/tasks/main.yml - GCE provisioning
roles/cloud-gce/tasks/main.yml - Other cloud provisioning
roles
VPN and clients
- VPN server configuration
server.yml - WireGuard setup
roles/wireguard/tasks/main.yml - IPsec setup
roles/strongswan/tasks/main.yml - WireGuard key derivation
library/x25519_pubkey.py - Client profile generation
roles/wireguard/tasks/mobileconfig.yml - User management
users.yml - Generated client configurations
roles/strongswan/tasks/client_configs.yml
Server features
- Local DNS and ad blocking
roles/dns/tasks/main.yml - SSH tunneling
roles/ssh_tunneling/tasks/main.yml - Privacy enhancements
roles/privacy/tasks/main.yml
Other components
- VPN operator
- Cloud provider
- VPN client device
Connections 23
- VPN operator → Deployment launcher: runs deployment
README.md - VPN operator → Deployment configuration: sets options
README.md - Deployment launcher → Ansible deployment: starts deployment
- Ansible deployment → Cloud setup playbooks: provisions host
- Cloud setup playbooks → DigitalOcean provisioning: selects provider
- Cloud setup playbooks → EC2 provisioning: selects provider
- Cloud setup playbooks → Lightsail provisioning: selects provider
- Cloud setup playbooks → Azure provisioning: selects provider
- Cloud setup playbooks → GCE provisioning: selects provider
- Cloud setup playbooks → Other cloud provisioning: selects provider
- Cloud provider → Cloud setup playbooks: hosts deployment
README.md - Ansible deployment → VPN server configuration: configures server
- VPN server configuration → WireGuard setup: configures VPN
- VPN server configuration → IPsec setup: configures VPN
- WireGuard setup → WireGuard key derivation: derives keys
- WireGuard setup → Client profile generation: generates profiles
- IPsec setup → Generated client configurations: generates profiles
- VPN server configuration → User management: manages users
- VPN server configuration → Local DNS and ad blocking: optionally configures
README.md - VPN server configuration → SSH tunneling: optionally configures
README.md - VPN server configuration → Privacy enhancements: configures privacy
README.md - Generated client configurations → VPN client device: configures device
README.md - Client profile generation → VPN client device: configures device
README.md