Activate your PhantomYerra enterprise license to unlock team features, cloud sync, and license-bound AI key delivery.
License required: A valid PhantomYerra license key is required to use the platform. Enter your key at first launch or navigate to Settings → License at any time to activate or manage your license.
Prerequisites
PhantomYerra installed and running (any platform)
License key received via email from Ravi Yerra / sales
Internet connection to reach license.dastcloud.com
Machine fingerprint will be recorded on first activation
1
Open License Settings
In PhantomYerra, navigate to Settings → License from the left sidebar (or click the Shield icon in the nav).
💡 Keyboard shortcut: Ctrl+, opens Settings. Press L to jump to License tab.
2
Enter Your License Key
Paste your license key in the format PY-XXXX-XXXX-XXXX-XXXX into the License Key field. Click Activate License.
The license server validates your key, records the machine fingerprint, and — if your license tier includes it — returns the bundled AI API key. The AI key is automatically stored encrypted at data/ai_keys.enc.
4
Verify Activated Status
The License panel now shows:
Status : ✅ Active
Tier : Single Seat — Enterprise Perpetual
Seat : seat-001
AI Key : Provided by license (encrypted)
Expires : Perpetual (no expiry)
⏱️ Activation takes under 10 seconds with a working internet connection.
Prerequisites
Team license key (PY-TEAM-XXXX format)
PostgreSQL 16+ database for multi-user mode
Network access between all team member machines and the DB server
super_admin account credentials for initial setup
1
Activate the Team License on Admin Machine
On the designated admin machine, go to Settings → License, enter the team license key, and click Activate License. This machine becomes the team admin host.
2
Configure PostgreSQL Connection
In Settings → Database → Switch to Team Mode, enter your PostgreSQL connection string:
Host : db.your-org.internal
Port : 5432
Database : phantomyerra_team
Username : phantomyerra_user
Password : [your db password]
PhantomYerra runs Alembic migrations automatically on first connect.
3
Create Team Member Accounts
Go to Settings → Users → Add User. Assign roles: pentest_lead, tester, reviewer, or client. Team members receive an invite email with their initial password.
4
Distribute to Team Members
Team members install PhantomYerra, go to Settings → License → Join Team, and enter the team server address. Their credentials authenticate them against the shared database.
⏱️ Team setup: 30–60 minutes including PostgreSQL configuration and user provisioning.
Prerequisites
Enterprise license key (PY-ENT-XXXX format)
SAML 2.0 / Okta / Azure AD IdP details (for SSO)
PostgreSQL cluster for high availability
IT admin access for SSO configuration
1
Activate Enterprise License
Same as Single Seat activation, but the enterprise key unlocks: unlimited seats, SSO, RBAC, ServiceNow CMDB sync, SAML 2.0, and compliance reporting.
2
Configure SSO (SAML 2.0 / Okta / Azure AD)
Navigate to Settings → SSO Configuration. Enter your IdP metadata URL or upload the XML metadata file. Map SAML attributes to PhantomYerra roles.
In Settings → Integrations → ServiceNow, enter your ServiceNow instance URL and credentials. Discovered assets from network scans will auto-populate CMDB records.
⏱️ Enterprise setup: 2–4 hours including SSO configuration and integration testing.
Common Issues
Check your firewall allows outbound HTTPS (port 443) to license.dastcloud.com. In air-gapped environments, contact support for an offline activation token.
Single-seat licenses bind to one machine fingerprint. If you've replaced your machine, contact support at support@dastcloud.com with your license key and old/new machine details to transfer the activation.
AI key bundling requires an "AI-Included" license tier. Check your license tier in Settings → License. If your tier includes AI, try clicking Re-sync License. If the issue persists, manually enter your Claude API key via Settings → AI Configuration.
Verify PostgreSQL is listening on all interfaces (listen_addresses = '*' in postgresql.conf), the firewall allows port 5432 from team member IPs, and pg_hba.conf permits the PhantomYerra user from the relevant subnets.