spawn
Create VPS instances on your configured cloud provider. Instances are named with the pattern {fleet-name}-{number}.
Usage
fleex spawn [flags]
Flags
| Flag | Short | Description | Default |
|---|---|---|---|
--name |
-n |
Fleet name | pwn |
--count |
-c |
Number of instances to spawn | 2 |
--provider |
-p |
Cloud provider (linode, digitalocean, vultr) | config default |
--region |
-R |
Data center region | config default |
--size |
-S |
Instance size/type | config default |
--image |
-I |
OS image | config default |
--build |
-b |
Build recipe to run after spawn | |
--no-verify |
Skip build verification | false |
|
--skipwait |
Skip waiting for instances to be ready | false |
Basic Usage
Spawn a fleet of 5 instances:
fleex spawn -n myfleet -c 5
Output:
Spawning 5 instances for fleet 'myfleet'...
myfleet-1 spawning...
myfleet-2 spawning...
myfleet-3 spawning...
myfleet-4 spawning...
myfleet-5 spawning...
Waiting for instances to be ready...
myfleet-1 ready (192.168.1.1)
myfleet-2 ready (192.168.1.2)
myfleet-3 ready (192.168.1.3)
myfleet-4 ready (192.168.1.4)
myfleet-5 ready (192.168.1.5)
Spawn with Build Recipe
Spawn instances and automatically provision them with tools:
fleex spawn -n scanfleet -c 10 --build security-tools
This spawns 10 instances and runs the security-tools build recipe on each, installing nuclei, httpx, subfinder, and masscan.
Output:
Spawning 10 instances for fleet 'scanfleet'...
[...]
Building fleet 'scanfleet' with recipe 'security-tools'...
[scanfleet-1] Step 1/5: System Update
[scanfleet-2] Step 1/5: System Update
[...]
Build complete: 10/10 successful
Provider Override
Use a different provider than configured default:
fleex spawn -n dofleet -c 3 -p digitalocean
Custom Instance Configuration
Override region, size, and image:
fleex spawn -n bigfleet -c 5 \
-p linode \
-R us-west \
-S g6-standard-2 \
-I linode/ubuntu22.04
Skip Wait
Spawn instances without waiting for them to be ready:
fleex spawn -n fastfleet -c 20 --skipwait
Use this for large fleets when you'll run commands later.
Fleet Naming
Instances follow the pattern {name}-{number}:
| Fleet Name | Count | Instance Names |
|---|---|---|
pwn |
3 | pwn-1, pwn-2, pwn-3 |
scan |
5 | scan-1, scan-2, scan-3, scan-4, scan-5 |
nuclei-fleet |
2 | nuclei-fleet-1, nuclei-fleet-2 |
Examples
Bug Bounty Fleet
Spawn 10 instances with security tools for bug bounty:
fleex spawn -n bugbounty -c 10 --build security-tools
Port Scanning Fleet
Spawn 20 small instances for distributed port scanning:
fleex spawn -n portscan -c 20 -S g6-nanode-1
Temporary Test Fleet
Spawn 2 instances for testing:
fleex spawn -n test -c 2
Multi-Region Fleet
Spawn instances in different regions (run separately):
fleex spawn -n us-fleet -c 5 -R us-east
fleex spawn -n eu-fleet -c 5 -R eu-west
Instance Sizes
Linode
| Size | RAM | vCPUs | Price/hour |
|---|---|---|---|
g6-nanode-1 |
1GB | 1 | $0.0075 |
g6-standard-1 |
2GB | 1 | $0.018 |
g6-standard-2 |
4GB | 2 | $0.036 |
DigitalOcean
| Size | RAM | vCPUs | Price/hour |
|---|---|---|---|
s-1vcpu-1gb |
1GB | 1 | $0.00744 |
s-1vcpu-2gb |
2GB | 1 | $0.01488 |
s-2vcpu-2gb |
2GB | 2 | $0.02679 |
Vultr
| Size | RAM | vCPUs | Price/hour |
|---|---|---|---|
vc2-1c-1gb |
1GB | 1 | $0.006 |
vc2-1c-2gb |
2GB | 1 | $0.012 |
vc2-2c-4gb |
4GB | 2 | $0.024 |
Workflow
Typical workflow:
- Estimate costs:
fleex estimate -t targets.txt -i 10 - Spawn fleet:
fleex spawn -n scan -c 10 --build security-tools - Verify fleet:
fleex status scan - Run scan:
fleex scan -n scan -w quick-scan -i targets.txt -o results.txt - Delete fleet:
fleex delete -n scan
Notes
- Fleex waits for all instances to be ready before completing (unless
--skipwaitis used) - SSH keys from configuration are automatically added to instances
- Use
fleex lsto list running instances - Use
fleex statusfor detailed fleet information - Use
fleex delete -n {name}to remove a fleet