Agent Builder Tab Not Appearing in UI Despite Correct Configuration

[johnfromberkeley]

LibreChat Version: ghcr.io/danny-avila/librechat-dev:latest
Deployment: Dokploy (Docker Compose)

Problem

The Agent Builder tab is not appearing in the UI. I have followed every troubleshooting step I could find, (See below)

Questions

1. Is ENDPOINTS=agents alone (without other endpoints listed, I use OpenRouter) a valid configuration, or does it need to be combined with other values?
2. Is there anything specific about a Dokploy Docker Compose deployment that could cause the agents endpoint to not register correctly?
3. Are there startup logs I should be looking for that would confirm whether the agents endpoint is being loaded? If so, what strings should I grep for?
4. Is there a known issue where the USER role permissions in MongoDB can be correct but still be overridden elsewhere?

Any help appreciated. Happy to provide logs if pointed in the right direction.

I studied this thread, I'm not able to see the agent builder on the UI #7280, and I have already tried the following troubleshooting steps:

1. Added ENDPOINTS=agents to .env
2. Configured interface.agents: true in librechat.yaml
3. Configured endpoints.agents in librechat.yaml
4. Verified MongoDB USER role has AGENTS: { USE: true, CREATE: true }

OpenRouter is working correctly as a custom endpoint - I am actively using it to browse and post this issue.

What I Have Tried

• Setting interface.agents as both an object with use: true and as a simple boolean true
• Setting disableBuilder: false explicitly under endpoints.agents
• Updating MongoDB permissions directly
• Changing config version from 1.2.1 to 1.2.8

Configuration

.env

HOST=0.0.0.0
PORT=3080
DOMAIN_CLIENT=https://librechat-librechat-7d7bc4-46-225-235-251.traefik.me
DOMAIN_SERVER=https://librechat-librechat-7d7bc4-46-225-235-251.traefik.me
MEILI_MASTER_KEY=REDACTED
JWT_SECRET=REDACTED
JWT_REFRESH_SECRET=REDACTED
CREDS_KEY=REDACTED
CREDS_IV=REDACTED
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GOOGLE_KEY=
OPENROUTER_KEY=REDACTED
POSTGRES_DB=librechat_db
POSTGRES_USER=librechat_user
POSTGRES_PASSWORD=REDACTED
APP_TITLE=LibreChat
CUSTOM_FOOTER=Made with ❤️ by LibreChat
ALLOW_EMAIL_LOGIN=true
ALLOW_REGISTRATION=true
ALLOW_SOCIAL_LOGIN=false
RAG_OPENAI_API_KEY=
RAG_GOOGLE_API_KEY=
EMBEDDINGS_PROVIDER=openai
EMBEDDINGS_MODEL=text-embedding-3-small
CHUNK_SIZE=1500
CHUNK_OVERLAP=100
ENDPOINTS=agents

librechat.yaml

version: ghcr.io/danny-avila/librechat-dev:latest
cache: true

interface:
    agents: true

endpoints:
    agents:
        disableBuilder: false
    custom:
        - name: "OpenRouter"
          apiKey: "${OPENROUTER_KEY}"
          baseURL: "https://openrouter.ai/api/v1"
          models:
              default: ["meta-llama/llama-3.3-70b-instruct:free"]
              fetch: true
          titleConvo: true
          titleModel: "current_model"
          summarize: false
          summaryModel: "current_model"
          forcePrompt: false
          dropParams: ["stop"]
          modelDisplayLabel: "OpenRouter"

MongoDB roles collection (USER role)

[
  {
    "_id": "ObjectId('69aa195faea06b8c49d3c3d2')",
    "name": "USER",
    "permissions": {
      "BOOKMARKS": { "USE": true },
      "PROMPTS": { "USE": true, "CREATE": true, "SHARE": false, "SHARE_PUBLIC": false },
      "MEMORIES": { "USE": true, "CREATE": true, "UPDATE": true, "READ": true, "OPT_OUT": true },
      "AGENTS": { "USE": true, "CREATE": true, "SHARE": false, "SHARE_PUBLIC": false },
      "MULTI_CONVO": { "USE": true },
      "TEMPORARY_CHAT": { "USE": true },
      "RUN_CODE": { "USE": true },
      "WEB_SEARCH": { "USE": true },
      "PEOPLE_PICKER": { "VIEW_USERS": false, "VIEW_GROUPS": false, "VIEW_ROLES": false },
      "MARKETPLACE": { "USE": true },
      "FILE_SEARCH": { "USE": true },
      "FILE_CITATIONS": { "USE": true },
      "MCP_SERVERS": { "USE": true, "CREATE": true, "SHARE": false, "SHARE_PUBLIC": false },
      "REMOTE_AGENTS": { "USE": true, "CREATE": true, "SHARE": true, "SHARE_PUBLIC": true }
    },
    "__v": 0
  }
]

[danny-avila]

Looking into this but for now, can you share the logs at startup for librechat?

Log locations:

• Docker: Project root directory ./logs
• npm: ./api/logs

There are two types of logs that can help diagnose the issue:

• debug logs (debug-YYYY-MM-DD.log)
• error logs (error-YYYY-MM-DD.log)

[johnfromberkeley]

Also,

I studied this thread, I'm not able to see the agent builder on the UI #7280, and I have already tried the following troubleshooting steps:

Can you share a screenshot of what you see in the UI?

[danny-avila]

Thanks for the kind words and the detailed logs!

You should try the following

1. Browser DevTools: Network tab

Open DevTools > Network, reload the page, and look for the endpoints request. Check the JSON response: does it contain an agents key? If agents is missing from that response, the Agent Builder tab won't render. Share the response here if you can.

2. ENDPOINTS=agents is likely the problem

This env var replaces the entire default endpoint list: it doesn't add to it. Setting ENDPOINTS=agents tells LibreChat "only enable agents, disable everything else." Since agents rely on other providers for their models, this can cause issues.

Fix: Remove ENDPOINTS from your .env entirely. Agents is enabled by default. If you want to be explicit:

ENDPOINTS=agents,custom

3. Logs: need more observability

The error log is useful, but info-level and debug-level logs would tell us exactly what's happening at boot (config loading, endpoint registration, etc.). Your debug log file is empty because DEBUG_LOGGING isn't enabled.

Add these to your .env:

DEBUG_LOGGING=true
DEBUG_CONSOLE=false

This writes debug logs to /app/logs/debug-YYYY-MM-DD.log inside the container. Make sure you have a volume mount for logs: in your Docker Compose, add this under the LibreChat service volumes if it's not already there:

volumes:
  - ./logs:/app/logs

After restarting, the ./logs/ directory on your host will have both error-*.log and debug-*.log files.

Also: wherever Dokploy gives you observability into container stdout, the info-level logs there during boot would be helpful too. Look for lines about "Custom config file loaded" which will confirm your librechat.yaml is being parsed correctly.

TL;DR

• Remove ENDPOINTS=agents from .env (or change to ENDPOINTS=agents,custom)
• Add DEBUG_LOGGING=true to .env
• Ensure ./logs:/app/logs volume mount exists
• Restart the container
• Check the endpoints network request in browser DevTools (filter network requests)
• Share the debug log and endpoints response if the issue persists

[johnfromberkeley]

Thank you, Danny-

I already have this in my Docker Compose file:

• librechat_data:/app/logs

I’m wondering if that makes a difference? (this is all new to me).

[johnfromberkeley]

@danny-avila fyi, I’m out of pocket for a couple of days, but so far none of this has worked. I probably can’t return to this issue until next week. Fortunately I have two other instances running and agent builder is appearing, so I’ll make do with those for now.

[johnfromberkeley]

Hi, @danny-avila!

FYI, I wiped Dokploy altogether and did a clean docker compose and of course… It’s brilliant! I am back in action and that dokploy template probably sucks.