# Installing Fides With Kubernetes

This guide will help you deploy Fides on Kubernetes using the official [Helm chart (opens in a new tab)](https://github.com/ethyca/fides-helm) with in-cluster PostgreSQL and Redis for development and testing.

This guide deploys PostgreSQL and Redis **inside your Kubernetes cluster** for a simple, self-contained setup. For production deployments using external managed databases and Redis, see the [Production Kubernetes Deployment](/content/docs/platform/installation/production/kubernetes/index.html) guide.

## Prerequisites [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#prerequisites/index.html)

Before deploying the Helm chart, you will need:

- [Helm v3 (opens in a new tab)](https://helm.sh/docs/intro/install/) installed on your machine
- A Kubernetes cluster to which Fides will be deployed
- `kubectl` configured to access your cluster

## Configuration [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#configuration/index.html)

Create a local values file (e.g., `values.local.yaml`) with the following configuration:

```
# values.local.yaml - In-cluster setup for development/testing
fides:
  publicHostname: "fides.example.com"

privacyCenter:
  publicHostname: "privacy.example.com"

# Deploy PostgreSQL and Redis in-cluster
postgresql:
  deployPostgres: true

redis:
  deployRedis: true
```

This configuration will:

- Deploy a PostgreSQL database inside your cluster
- Deploy a Redis instance inside your cluster
- Set up Fides with default credentials and configuration

⚠️

**Not for Production Use**: This setup uses default credentials and runs databases in-cluster without persistence or backup configurations. For production deployments with external managed services, security hardening, and high-availability, see the [Production Kubernetes Deployment](/content/docs/platform/installation/production/kubernetes/index.html) guide.

### Additional Configuration Options [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#additional-configuration-options/index.html)

You can customize your deployment further by adding these options to your `values.local.yaml`:

**Custom Environment Variables:**

```
fides:
  configuration:
    # Add plain environment variables
    additionalEnvVars:
      - name: LOG_LEVEL
        value: "INFO"
    # Reference sensitive values from a Kubernetes secret
    additionalEnvVarsSecret: "my-custom-secrets"
```

**Worker Configuration:**
Configure background worker pods for privacy request processing, consent management, and other tasks. See the [Workers Reference](/content/docs/platform/workers/index.html) for detailed configuration options and scaling recommendations.

**S3 Storage (Optional):**
To manage an S3 bucket for privacy request exports directly from Kubernetes using AWS Controllers for Kubernetes (ACK):

1. Install [ACK for S3 (opens in a new tab)](https://aws-controllers-k8s.github.io/community/docs/user-docs/install/) following the official setup
2. Enable [IAM Roles for Service Accounts (IRSA) (opens in a new tab)](https://aws-controllers-k8s.github.io/community/docs/user-docs/irsa/)
3. Add to your `values.local.yaml`:

```
s3:
  createS3Bucket: true
  bucketName: "my-fides-bucket"
  region: "us-east-1"
```

For a complete list of all available configuration options, see the [Fides Helm chart values.yaml (opens in a new tab)](https://github.com/ethyca/fides-helm/blob/main/fides/values.yaml).

**Useful resources:**

- [Fides Configuration Guide](/content/docs/platform/configuration/configuration/index.html) - All configuration options
- [Workers Reference](/content/docs/platform/workers/index.html) - Configure background workers
- [Requirements](/content/docs/platform/installation/requirements/index.html) - System and configuration requirements

## Installation [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#installation/index.html)

### Add the Helm Repository [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#add-the-helm-repository/index.html)

First, add the Ethyca Helm repository:

```
helm repo add ethyca https://helm.ethyca.com
helm repo update
```

### Install Fides [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#install-fides/index.html)

Install the chart with your custom values:

```
helm install fides ethyca/fides --values values.local.yaml
```

### Verify Installation [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#verify-installation/index.html)

Check that all pods are running:

```
kubectl get pods
```

You should see pods for:

- Fides webserver
- Privacy Center
- PostgreSQL (in-cluster)
- Redis (in-cluster)

## Accessing Fides [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#accessing-fides/index.html)

Once deployed, you can access Fides through:

- **Fides Admin UI**: `http://<fides.publicHostname>` or port-forward for local access:

```
kubectl port-forward svc/fides 8080:8080
```

- **Privacy Center**: `http://<privacyCenter.publicHostname>` or port-forward:

```
kubectl port-forward svc/fides-privacy-center 3000:3000
```

## Next Steps [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#next-steps/index.html)

- Configure [storage destinations](/content/docs/privacy-requests/guides/storage-destinations/index.html) for privacy request exports
- Set up [integrations](/content/docs/integrations/index.html) to connect to your data systems
- Configure [background workers](/content/docs/platform/workers/index.html) for processing privacy requests
- When ready for production, see the [Production Kubernetes Deployment](/content/docs/platform/installation/production/kubernetes/index.html) guide

## Additional Resources [Permalink for this section](/content/docs/platform/installation/basic/kubernetes#additional-resources/index.html)

- [Fides Helm Chart Repository (opens in a new tab)](https://github.com/ethyca/fides-helm) - Official Helm chart source and documentation
- [Helm Documentation (opens in a new tab)](https://helm.sh/docs/) - Learn more about Helm
- [Quick Start](/content/docs/getting-started/index.html) - Try the complete Fides demo

[Pip](/content/docs/platform/installation/basic/pip "Pip"/index.html) [Architecture Overview](/content/docs/platform/installation/production/architecture "Architecture Overview"/index.html)