NocoDB MCP Server

# Adding MinIO S3 Configuration to NocoDB in Coolify

## Quick Steps

Since you're using Coolify, you need to add the MinIO S3 environment variables to your **NocoDB service**, not the MCP server service.

### Step 1: Access NocoDB Service in Coolify

1. Log into your Coolify dashboard
2. Find your **NocoDB** service (not the MCP server)
3. Click on the service to open its settings

### Step 2: Add Environment Variables

1. Navigate to **Environment Variables** section
2. Click **Add Environment Variable** for each of the following:

```bash
NC_S3_BUCKET_NAME=nocodb-storage
NC_S3_REGION=us-east-1
NC_S3_ENDPOINT=https://minio-api.v1su4.com
NC_S3_ACCESS_KEY=your_minio_access_key_here
NC_S3_ACCESS_SECRET=your_minio_secret_key_here
NC_S3_FORCE_PATH_STYLE=true
NC_S3_ACL=public-read
```

### Step 3: Use Coolify Secrets (Recommended)

For sensitive values (`NC_S3_ACCESS_KEY` and `NC_S3_ACCESS_SECRET`):

1. Go to **Secrets** in Coolify
2. Create secrets:
   - `MINIO_ACCESS_KEY` = your MinIO access key
   - `MINIO_SECRET_KEY` = your MinIO secret key
3. Reference them in environment variables:
   - `NC_S3_ACCESS_KEY={{MINIO_ACCESS_KEY}}`
   - `NC_S3_ACCESS_SECRET={{MINIO_SECRET_KEY}}`

### Step 4: Restart NocoDB Service

1. After adding all variables, **restart** the NocoDB service
2. Check logs to verify MinIO connection
3. Test by uploading a file in NocoDB

## Prerequisites

Before adding these variables, ensure:

1. ✅ **MinIO bucket exists**: `nocodb-storage` bucket created in MinIO
2. ✅ **Access keys created**: MinIO access key and secret key generated
3. ✅ **MinIO accessible**: `https://minio-api.v1su4.com` is reachable from NocoDB container

## Verification

After restarting NocoDB:

1. Log into NocoDB: `https://nocodb.v1su4.com`
2. Upload a file/attachment to any table
3. Check MinIO bucket: `https://minio-api.v1su4.com/nocodb-storage/`
4. Verify file appears in MinIO

## Troubleshooting

### Variables Not Applied

- ✅ Check variable names are correct (case-sensitive)
- ✅ Ensure no typos in values
- ✅ Verify service was restarted after adding variables

### Connection Errors

- ✅ Test MinIO endpoint: `curl https://minio-api.v1su4.com`
- ✅ Verify access keys are correct
- ✅ Check network connectivity between NocoDB and MinIO

### Files Not Uploading

- ✅ Check `NC_S3_FORCE_PATH_STYLE=true` is set
- ✅ Verify bucket exists and has proper permissions
- ✅ Check NocoDB logs for S3 errors

## Reference

- See `MINIO_S3_CONFIGURATION.md` for detailed configuration guide
- See `docker-compose.nocodb.example.yaml` for docker-compose reference (if not using Coolify)