Help:how to change a chat flow default logo. I uploade a jpg picture, but it can not correctly show

[simonjhy]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (我已阅读并同意 Language Policy).
• [FOR CHINESE USERS] 请务必使用英文提交 Issue，否则会被关闭。谢谢！:)
• Please do not modify this template :) and fill in all the required fields.

1. Is this request related to a challenge you're experiencing? Tell me about your story.

how to change a chat flow default logo. I uploade a jpg picture, but it can not correctly show. What's requirement of the logo? what's size and format, jpg or png?

2. Additional context or comments

No response

[dosubot[bot]]

To change the chat flow logo in Dify, you can upload an image (JPG, PNG, GIF, WEBP, SVG, under 10 MB), but if your JPG isn't displaying correctly, it's usually due to configuration issues in self-hosted or Docker setups. Make sure your .env file sets FILES_URL to your host's actual IP and port (for example, http://localhost:5001), and that your Docker Compose exposes port 5001 for the backend file server. Also, check that Docker volumes are mapped so both backend and frontend containers can access uploaded images. If the logo still doesn't show, clear your browser cache and check for CORS errors in the browser console. Full image rendering support was added after Dify version 1.9.1, so upgrading to a newer version may be necessary for proper logo display. More details and troubleshooting steps are available here and here.

If you want to use different images for branding (app icon, sidebar logo, chat answer logo), you need to manually replace the static files in the /logo/ directory of the frontend codebase—there's no built-in UI for dynamic logo selection yet. See this discussion for more info.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[simonjhy]

I used this
FILES_URL=http://api:5001
INTERNAL_FILES_URL=http://api:5001

Is this correct? I use dify with docker, what's setting I need to change or where Can I manually change the app icon?

My dify version is 1.11.4. Can you give me the detail steps of how to replace app icon, sidebar logo, chat answer logo?

[dosubot[bot]]

For Docker deployments, FILES_URL should be set to your host’s actual IP and port (for example, http://192.168.x.x:5001), not localhost or http://api:5001. INTERNAL_FILES_URL should be unset or left blank unless you specifically need internal-only access. If INTERNAL_FILES_URL is set to http://api:5001, file/image URLs generated for the browser will not work externally. After updating these variables, restart Docker with docker-compose down && docker-compose up -d and make sure port 5001 is exposed in your docker-compose.yml (details, more).

To replace branding images in Dify v1.11.4:

1. App Icon: Replace the PNG files (icon-192x192.png, icon-256x256.png, icon-384x384.png, icon-512x512.png) in web/public. These are referenced in manifest.json (source).
2. Sidebar Logo: Replace web/public/logo/logo.png with your desired image (source).
3. Chat Answer Logo: Replace web/public/logo/logo-embedded-chat-avatar.png (or similar) (source).

After replacing these files, rebuild the frontend (in the web directory: pnpm install && pnpm build) and redeploy. If the new logos don’t show up, clear your browser cache or do a hard refresh. For persistent issues, check Docker volume mappings and static asset caching in your proxy/Nginx setup (troubleshooting).

There’s no built-in UI for dynamic logo selection; you must manually replace these files for each branding image. If you need more flexible branding, you’d need to modify the frontend code (discussion).

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[simonjhy]

1. Which image is needed to expose 5001? api or web?
2. If I want to replace App, sidebar,Chat Answer logo, I need to rebuild docker image? Is there a simple way to replace or put some image to the volums folder to replace the logo?

[dosubot[bot]]

1. The API container is the one that needs to expose port 5001 for file/image serving. In your docker-compose.yml, under the api service, add:

ports:
  - "5001:5001"

Then restart your containers for the change to take effect. The web container does not use port 5001; it serves the frontend UI on port 3000 and does not handle file uploads or logo serving on 5001 reference.

2. For branding images (app icon, sidebar logo, chat answer logo), you do need to rebuild the web Docker image after replacing the files in web/public (for example: icon-192x192.png, logo/logo.png, logo/logo-embedded-chat-avatar.png). There is no default volume mapping to override these static assets—simply putting new images into a volume folder will not update the logos. If you want to avoid rebuilding, you’d have to manually add a custom volume mapping in your docker-compose.yml to mount a host directory over the container’s /app/web/public, but this is not part of the standard setup and requires extra configuration reference.

After redeploying, clear your browser cache or do a hard refresh to see the new images.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

   

[simonjhy]

Thank you .

Can you give me detail steps about what's the exacat volums mapping I need to change for branding images (app icon, sidebar logo, chat answer logo) replace action?

[dosubot[bot]]

You can override Dify's branding images (app icon, sidebar logo, chat answer logo) in Docker without rebuilding the image by mapping a host directory containing your replacement images to the container's /app/web/public directory. Here’s how:

1. On your host, create a directory (for example, ./custom-public) and place your replacement images there:

   • For app icons: icon-192x192.png, icon-256x256.png, icon-384x384.png, icon-512x512.png
   • For sidebar logo: logo/logo.png
   • For chat answer logo: logo/logo-embedded-chat-avatar.png

   The directory structure should look like:

   custom-public/
     icon-192x192.png
     icon-256x256.png
     icon-384x384.png
     icon-512x512.png
     logo/
       logo.png
       logo-embedded-chat-avatar.png
   

2. In your docker-compose.yml, under the web service, add a volumes section to map your host directory to /app/web/public in the container:

   web:
     image: langgenius/dify-web:1.11.4
     # ... other config ...
     volumes:
       - ./custom-public:/app/web/public

3. Restart your containers:

   docker-compose down
   docker-compose up -d
   

4. Clear your browser cache or do a hard refresh to see the new images.

Make sure your replacement images have the same filenames as the originals. If you only want to override specific files, you can map individual files instead:

volumes:
  - ./custom-public/icon-192x192.png:/app/web/public/icon-192x192.png
  - ./custom-public/logo.png:/app/web/public/logo/logo.png
  # etc.

The container runs as a non-root user, so ensure your files are readable by all users on the host. This approach lets you update branding images without rebuilding the Docker image or losing changes on upgrade reference.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}