stop

This guide shows you how to stop a running Datafye Foundry deployment on your local machine without removing it.

Prerequisites

Before you begin, ensure:

• You have a running local Foundry deployment

• Docker Desktop is running on your machine

Stop Command

Use the following command to stop your local Foundry deployment:

datafye foundry local stop

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

Stop Process

When you stop the deployment, the CLI will:

1. Stop services gracefully - Send shutdown signals to all Datafye services

2. Wait for clean shutdown - Allow services to complete ongoing operations

3. Stop containers - Stop all Docker containers

4. Preserve state - Keep all configuration and data intact

5. Display status - Confirm deployment is stopped

Stopping preserves your deployment configuration and data. You can restart it later with datafye foundry local start.

After Stopping

Once stopped:

• All Datafye services will be inactive

• Docker containers will be stopped (but not removed)

• Your configuration and data are preserved

• System resources (CPU, memory) are freed

To resume work: Simply run datafye foundry local start when ready.

Your local Foundry deployment has been stopped successfully!

When to Stop

Stopping your deployment is useful for:

• Freeing resources when not actively using the deployment

• Pausing development work overnight or over weekends

• Resolving issues by performing a clean restart

• Updating configuration (requires stop, modify descriptors, then start)

Troubleshooting

Docker Not Running

If you see an error about Docker not being available:

1. Ensure Docker Desktop is running

2. The CLI needs Docker to stop containers even if they're already stopped

No Deployment Found

If you see an error that no local deployment exists:

1. Verify you've previously provisioned a deployment

2. Check if containers still exist: docker ps -a | grep datafye

Services Won't Stop

If services fail to stop gracefully:

1. Wait up to 30 seconds for graceful shutdown

2. The CLI will force-stop containers if needed

3. If issues persist, you can manually stop Docker containers: docker stop $(docker ps -q)

Related Commands

• Provision a Local Foundry - Create a new deployment

• Start a Local Foundry - Start a stopped deployment

• Deprovision a Local Foundry - Remove the deployment completely

---

Last updated: 2025-10-22