Quick Start

This guide will walk you through setting up your first dxflow engine and running a simple workflow in under 10 minutes.

Step 1: Verify Installation

First, confirm that dxflow is properly installed:

dxflow --version

You should see output similar to:

dxflow version v1.0.0

Step 2: Start the Engine

Launch your dxflow engine:

dxflow boot up

To learn more about engine management, see the CLI documentation.

Step 3: Access the Web Interface

With the engine running, open your web browser and navigate to:

• Local access: http://localhost
• Remote access: http://<your-server-ip>

You should see the dxflow web interface:

Step 4: Explore the Interface

The dxflow web interface provides four main sections for managing your workflows, files, and system resources.

Step 5: Create Your First Workflow

Let's create a simple "Hello World" workflow using Docker Compose:

5.1 Using the Web Interface

1. Navigate to the Workflows section
2. Click "Create Workflow"
3. Name your workflow: hello-world
4. Use this simple Docker Compose configuration:

version: '3.8'
services:
  hello:
    image: hello-world
    container_name: dxflow-hello

5. Click "Create" to save the workflow

5.2 Using the CLI

Alternatively, create the workflow via command line:

First, create a Docker Compose file:

# hello-compose.yml
version: '3.8'
services:
  hello:
    image: hello-world
    container_name: dxflow-hello

Then create the workflow using the CLI:

# Create the workflow
dxflow workflow compose create --identity hello-world hello-compose.yml

Step 6: Run the Workflow

Start the Workflow

Web Interface: Click the "Start" button next to your workflow

CLI: Use the command line:

dxflow workflow compose start hello-world

Monitor Progress

View Logs:

dxflow workflow compose logs hello-world

Check Status:

dxflow workflow compose list

Step 7: Explore Advanced Features

Now that you have a basic workflow running, explore additional capabilities:

File Management: dxflow object fs upload <local-path> <remote-path>

Shell Access: dxflow shell create <session-name>

Engine Health: dxflow healthcheck

Next Steps

🎉 Congratulations! You've successfully set up dxflow and created your first workflow.

Continue Learning

1. CLI Reference - Master all available commands
2. API Documentation - Integrate with your applications
3. Advanced Topics - Explore performance optimization and enterprise patterns

Troubleshooting

Engine fails to start:

• Check if port 80 is already in use
• Verify you have proper permissions
• Check system logs for specific errors

Web interface not accessible:

• Verify the engine is running: dxflow ping
• Check firewall settings allow port 80
• Ensure you're accessing the correct IP address

Workflow creation fails:

• Validate your Docker Compose syntax
• Ensure Docker is installed and running
• Check container image availability

Happy computing with dxflow! 🚀