Licensing
dxflow uses a permission-based licensing system to control access to various features and capabilities. Licenses are cryptographically signed to ensure authenticity.
Default License (General)
dxflow includes a General License that provides:
- Valid until: January 1, 2030
- Full access to all core features
- No registration required
- Perfect for evaluation, development, and general use
License Permissions
Licenses control access to the following modules:
Core Modules
- shell - Terminal access and command execution
- object - File storage and management
- platform - Docker and platform integrations
- workflow - Compose workflow orchestration
Network Modules
- bridge - Network bridge connections (with traffic limits)
- proxy - Proxy configurations and tunnels (with traffic limits)
Getting Your Identity
Before creating a license, you need your machine's unique identity:
dxflow engine info
Output example:
Identity: cc2bcf4a9fc3fa056189533df3ee3af6
Directory: /home/user/.dxflow
Profile: default
License Commands
View Current License
Check your active license details:
dxflow license info
Create a New License
The easiest way to create a license:
dxflow license create
This command:
- Opens your browser to the license portal
- Pre-fills your Identity and name
- Guides you through authentication
- Generates your license file
Activate a License
After downloading your license:
dxflow license activate <IDENTITY>
Creating a Custom License
Step 1: Run the Create Command
dxflow license create
Your browser will open with your details pre-filled.
Step 2: Authenticate
Choose your authentication method:
- Sign in with your Google account
- Verification through email address
- Quick and seamless process
- Perfect if you don't have a Google account
- Verify using any payment card
- No charges - card is for verification only
- We don't store or charge your card
Step 3: Configure Your License
Provide a name for your license. All other settings are automatically configured:
- Validity: 5 years (2025-2030)
- Permissions: All core modules enabled
- Bridge: 1 connection, 10MB traffic
- Proxy: Disabled by default
Step 4: Download and Activate
Download the generated license file and activate it:
dxflow license activate <IDENTITY>
License Format
dxflow licenses are JSON files with the following structure:
{
"identity": "your-machine-identity",
"name": "License Name",
"owner": "Anonymous",
"starts": "Mon, 01 Jan 2025 00:00:00 GMT",
"expires": "Mon, 01 Jan 2030 00:00:00 GMT",
"permission": {
"shell": {},
"object": {},
"platform": {},
"workflow": {},
"bridge": {
"count": 1,
"traffic": 10240000
}
},
"signature": "cryptographic-signature",
"issued": "Mon, 01 Jan 2025 00:00:00 GMT"
}
Using dxflow Without a License
The General License is perfect for:
- Trying out dxflow
- Development and testing
- Personal projects
- Small-scale deployments
You only need a custom license if you want to:
- Track usage with a personalized identity
- Prepare for post-2030 usage
- Meet organizational compliance requirements
Frequently Asked Questions
What happens if I don't have a license?
dxflow uses the built-in General license by default, providing full access to core features until 2030.
How are licenses verified?
Licenses use RSA cryptographic signatures to ensure they haven't been tampered with. Verification happens automatically on activation.
How do I get a license?
Simply run dxflow license create
. Your browser will open with your Identity pre-filled. After authenticating with Google or Stripe, you can download and activate your license.
I don't have a Google account. Can I still create a license?
Yes! Choose the Stripe authentication option. It works with any payment card and is just as easy. Your card is only used for identity verification - no charges will be made.
Why is authentication required?
Authentication prevents abuse and ensures each license is tied to a verified identity. Both Google and Stripe are used solely for identity verification - no payment or personal data is collected beyond what's needed for verification.
Need more capabilities?
If you need additional capabilities or custom license configurations, contact diphyx@gmail.com for assistance.
What if my license expires?
When your license expires, simply run:
dxflow license create
This will open your browser with your details pre-filled. After authenticating and creating a new license, activate it with:
dxflow license activate <IDENTITY>
Troubleshooting
License not verified
- Check that the license file hasn't been modified
- Ensure the license identity matches your machine's identity
- Verify system date/time is correct
License expired
- Check expiration date with
dxflow license info
- Create a new license using
dxflow license create
Invalid license signature
- The license file may be corrupted
- Download a fresh copy of your license
For license-related assistance:
- Check current status:
dxflow license info
- Report issues at GitHub