Getting Started with datax
datax is a desktop application that helps you deploy and manage data tools across multiple hosts using Docker containers. This guide will help you get started quickly.
What you'll need:
- • A computer running Windows, macOS, or Linux
- • One or more remote servers with SSH access
- • Docker installed on your target servers
Installation
Download datax
Choose the appropriate version for your operating system:
First Launch
After installation, launch datax and you'll be greeted with the main interface. No registration or setup is required.
Host Management
Adding Hosts
To deploy applications, you first need to add remote hosts to datax:
- 1. Click the "Add Host" button in the main interface
- 2. Enter the host details (IP address, SSH port, credentials)
- 3. Test the connection to ensure SSH access works
- 4. Save the host configuration
Host Requirements
- • SSH server running and accessible
- • Docker installed and running
- • User account with Docker permissions
- • Sufficient disk space for containers
Host Groups and Tags
Organize your hosts using groups and tags for easier management of large deployments.
Application Deployment
Using the App Store
datax includes a curated collection of pre-configured data tools:
🗄️ Databases
- • PostgreSQL 🐘
- • MySQL 🐬
- • Oracle Database 🔶
- • IBM DB2 🔷
🛠️ Management Tools
- • pgAdmin
- • MySQL Client 💻
⚙️ DATAX Tools
- • X0 Diagnosis 🔍
- • X1 Simulation 🎯
- • M3 Migration 📦
- • T3 Sync 🔄
- • V3 Comparison ⚖️
🔐 License Tools
- • License Control Server
- • License Control Dog 🐕
🎨 Custom Apps
- • User-defined applications
- • Custom Docker images
Deployment Process
- 1. Browse the app store and select an application
- 2. Choose target hosts for deployment
- 3. Configure application settings (ports, environment variables, volumes)
- 4. Click "Deploy" to start the installation
- 5. Monitor the deployment progress in real-time
Monitoring
Application Status
datax provides real-time monitoring of your deployed applications:
- • Container status (running, stopped, error)
- • Resource usage (CPU, memory, disk)
- • Network connectivity
- • Application logs
Host Metrics
Monitor the health and performance of your hosts through the dashboard interface.
Troubleshooting
Common Issues
SSH Connection Failed
- • Verify SSH server is running on the target host
- • Check firewall settings and port accessibility
- • Ensure credentials are correct
- • Test SSH connection manually from terminal
Docker Deployment Failed
- • Verify Docker is installed and running
- • Check user permissions for Docker commands
- • Ensure sufficient disk space
- • Review application logs for specific errors
Application Not Accessible
- • Check port configuration and conflicts
- • Verify firewall rules on the host
- • Ensure container is running and healthy
- • Review network configuration
Privacy & Logging
Data Privacy
datax is designed with privacy in mind:
- • All data is stored locally on your machine
- • No telemetry or usage data is collected
- • SSH credentials are encrypted locally
- • No data is transmitted to external servers
Local Logging
datax maintains local logs for troubleshooting:
- • Application events and errors
- • SSH connection attempts
- • Docker deployment activities
- • System performance metrics
Log Management
Logs are automatically rotated and can be cleared through the application settings. No sensitive information like passwords is logged.