start

This guide shows you how to start a stopped Datafye Trading Environment on your local machine.

Prerequisites

Before you begin, ensure:

• You have previously provisioned a local Trading Environment (see Provision a Local Trading Environment)

• The deployment is currently stopped

• Docker Desktop is running on your machine

Start Command

Use the following command to start your local Trading Environment:

datafye trading local start

Local deployments don't require a --name parameter since only one deployment is allowed per machine.

Start Process

When you start the deployment, the CLI will:

1. Verify Docker - Ensure Docker daemon is running

2. Start containers - Bring up all stopped Datafye service containers

3. Wait for services - Monitor service startup

4. Reconnect to broker - Re-establish broker connections

5. Run health checks - Verify all services are healthy

6. Display status - Show deployment is running

Starting a deployment is much faster than provisioning (typically under 1 minute) since the infrastructure and containers already exist.

After Starting

Once the start process completes, you'll see a success message and your deployment will be accessible:

• Data Cloud REST API: http://localhost:8080/datafye-api/v1/

• Data Cloud WebSocket: ws://localhost:8080/datafye-ws

• Broker Connector REST API: http://localhost:8081/broker-api/v1/

• Broker Connector WebSocket: ws://localhost:8081/broker-ws

• MCP Server (Full Stack only): http://localhost:3000

Validate Connectivity

Test your deployment with:

# Check Data Cloud health
curl http://localhost:8080/datafye-api/v1/health

# Check Broker Connector health
curl http://localhost:8081/broker-api/v1/health

Your local Trading Environment is now running!

Troubleshooting

Docker Not Running

If you see an error about Docker not being available:

1. Start Docker Desktop

2. Wait for Docker to fully start

3. Retry the start command

No Deployment Found

If you see an error that no local deployment exists:

1. Verify you've previously provisioned a deployment

2. If not, provision one first: datafye trading local provision

Container Start Failures

If containers fail to start:

1. Check Docker logs: docker ps -a and docker logs <container-id>

2. Verify sufficient Docker resources (RAM, disk space)

3. If issues persist, deprovision and re-provision the deployment

Broker Connection Issues

If broker connections fail on start:

1. Verify broker credentials haven't expired

2. Check broker service status

3. Ensure environment variables with credentials are still set

4. Review Broker Connector logs for specific errors

Related Commands

• Provision a Local Trading Environment - Create a new deployment

• Stop a Local Trading Environment - Stop the running deployment

• Deprovision a Local Trading Environment - Remove the deployment

---

Last updated: 2025-10-22