deprovision

This guide shows you how to completely remove a Datafye Foundry deployment from your local machine.

Prerequisites

Before you begin, ensure:

• You have previously provisioned a local Foundry deployment

• Docker Desktop is running on your machine

Warning: Deprovisioning is irreversible. All deployment data will be permanently deleted, including configurations, databases, and downloaded data. Ensure you have backed up any critical data before proceeding.

Deprovision Command

Use the following command to deprovision your local Foundry deployment:

datafye foundry local deprovision

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

Confirmation

The CLI will prompt you to confirm the deprovision operation:

WARNING: This will permanently delete your local Foundry deployment and all data.
Are you sure you want to continue? (yes/no):

Type yes to proceed with deprovisioning.

Skip confirmation:

datafye foundry local deprovision --force

Deprovision Process

When you deprovision the deployment, the CLI will:

1. Stop services - Gracefully stop all running Datafye services

2. Remove containers - Delete all Docker containers

3. Remove networks - Delete the Docker network

4. Remove volumes - Delete all data volumes (configuration, databases, caches)

5. Remove images (optional) - Delete Docker images if no longer needed

6. Clean up state - Remove deployment metadata

7. Display status - Confirm successful deprovisioning

The deprovisioning process typically takes 1-2 minutes. Do not interrupt it.

After Deprovisioning

Once deprovisioning completes:

• All Datafye containers are removed

• All data and configuration are permanently deleted

• Docker resources are freed

• Your machine is clean for a new deployment if desired

To create a new deployment: Run datafye foundry local provision with your descriptor files.

Your local Foundry deployment has been completely removed!

When to Deprovision

Deprovision your deployment when:

• No longer needed - You're done with the deployment and won't use it again

• Starting fresh - You want to recreate the deployment from scratch

• Freeing disk space - You need to reclaim the storage used by containers and data

• Troubleshooting - Resolving persistent issues by removing and re-provisioning

• Changing scenarios - Switching between Data Cloud Only and Full Stack

Troubleshooting

Docker Not Running

If you see an error about Docker not being available:

1. Start Docker Desktop

2. The CLI needs Docker to remove containers

3. Retry the deprovision command

No Deployment Found

If you see an error that no local deployment exists:

1. The deployment may already be deprovisioned

2. Check for any remaining containers: docker ps -a | grep datafye

3. Manually clean up if needed: docker rm -f $(docker ps -aq -f name=datafye)

Partial Deprovision

If deprovisioning fails partway through:

1. Review the error message

2. Retry the deprovision command

3. If issues persist, manually clean up:

   # Remove containers
   docker rm -f $(docker ps -aq -f name=datafye)
   
   # Remove volumes
   docker volume rm $(docker volume ls -q -f name=datafye)
   
   # Remove network
   docker network rm datafye-network

Containers Won't Remove

If containers fail to remove:

1. Ensure all containers are stopped first

2. Use force flag: datafye foundry local deprovision --force

3. Manually force-remove: docker rm -f <container-id>

Related Commands

• Provision a Local Foundry - Create a new deployment

• Start a Local Foundry - Start a stopped deployment

• Stop a Local Foundry - Stop a running deployment

---

Last updated: 2025-10-22