# Dify App Configuration via Database

**Document ID:** FFG-DEP-DIFY-001
**Created:** April 12, 2026 (Chronicler #84 — The Meridian)
**Purpose:** How to configure Dify apps without using the UI (avoids "everything disappears if you don't publish" problem)

---

## Why This Exists

Dify's web UI loses unsaved changes if you navigate away before publishing. The API uses session-based auth that's not easily accessible. The cleanest approach is direct database manipulation via the Dify PostgreSQL container.

---

## Key Database Info

- **Container:** `firefrost-codex-db-1` on TX1 Dallas (38.68.14.26)
- **Database:** `dify`
- **User:** `postgres`
- **Access:** `docker exec firefrost-codex-db-1 psql -U postgres -d dify -c "..."`

---

## Key Tables

| Table | Purpose |
|-------|---------|
| `apps` | App name, mode, config ID |
| `app_model_configs` | Model, system prompt, dataset config |
| `app_dataset_joins` | Links apps to knowledge bases |
| `api_tokens` | API keys per app |
| `datasets` | Knowledge bases |

---

## Common Operations

### Rename an app
```sql
UPDATE apps SET name = 'The Forge' WHERE id = '<app_id>';
```

### Find app ID by name
```sql
SELECT id, name, mode FROM apps ORDER BY created_at DESC LIMIT 10;
```

### Get app API token
```sql
SELECT token FROM api_tokens WHERE app_id = '<app_id>';
```

### Link KB to app
```sql
INSERT INTO app_dataset_joins (app_id, dataset_id)
VALUES ('<app_id>', '<dataset_id>');
```

### Update dataset config (enable hybrid search)
```sql
UPDATE app_model_configs 
SET dataset_configs = '{
  "retrieval_model": "multiple",
  "datasets": {
    "datasets": [{
      "dataset": {
        "enabled": true,
        "id": "<dataset_id>"
      }
    }]
  }
}'::jsonb
WHERE id = '<config_id>';
```

### Get config ID for an app
```sql
SELECT app_model_config_id FROM apps WHERE name = 'The Forge';
```

---

## The Forge — Current State (April 12, 2026)

| Property | Value |
|----------|-------|
| App ID | `faf87e2a-1e98-4a0b-af14-b997ad1d3482` |
| Config ID | `805eae6e-4cfd-43da-9e8b-3bc979a736b2` |
| API Token | `app-forge-trinity-console-key` |
| Model | `gemma4:26b-a4b-it-q8_0` |
| KB (v2) | `3776b10b-918d-48d8-933b-e3dd0655838a` |

## Awakened Concierge — Current State (April 12, 2026)

| Property | Value |
|----------|-------|
| App ID | `329a6bdb-5b19-45ce-a003-1861a5473d39` |
| API Token | `app-pwucQuDCos5VXlVTQHnXPZAD` |
| Model | `gemma4:26b-a4b-it-q8_0` |
| KB | None (prompt-only) |

---

**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️