404 on Instance /docs URL. #48

New Issue

2026-02-15T17:05:28-05:00

yindo commented

2026-02-15 17:05:28 -05:00

Originally created by @adamoutler on GitHub (Oct 20, 2024).

According to docs.openwebui.com/api, I understand there should be documents at ai.my.com/docs, but all i see is a 404: Not Found. I'd expect to see documentation on Completion/Chat/Search APIs but I am not able to access it with ghcr.io/open-webui/open-webui:main as the instance.

Originally created by @adamoutler on GitHub (Oct 20, 2024). According to [docs.openwebui.com/api](https://docs.openwebui.com/api/#swagger-documentation-links), I understand there should be documents at `ai.my.com/docs`, but all i see is a 404: Not Found. I'd expect to see documentation on Completion/Chat/Search APIs but I am not able to access it with `ghcr.io/open-webui/open-webui:main` as the instance.

yindo closed this issue

2026-02-15 17:05:28 -05:00

yindo commented

2026-02-15 17:05:28 -05:00

@TheRealPSV commented on GitHub (Oct 30, 2024):

This looks like the repo for the site docs, not the OpenAPI docs, so I think this issue should actually be posted over here in the main repo: https://github.com/open-webui/open-webui/issues

To answer your question though, it looks like the code is set up so you can't view the root /docs without a dev environment variable set up: https://github.com/open-webui/open-webui/blob/09935d191f34a35d81cc0fbd58b035e6e5068efc/backend/open_webui/main.py#L185

Since it looks like you're using a docker image, just pass the env var ENV=dev and it should work, although I don't know if this will have other unintended consequences.

@TheRealPSV commented on GitHub (Oct 30, 2024): This looks like the repo for the site docs, not the OpenAPI docs, so I think this issue should actually be posted over here in the main repo: https://github.com/open-webui/open-webui/issues To answer your question though, it looks like the code is set up so you can't view the root `/docs` without a dev environment variable set up: https://github.com/open-webui/open-webui/blob/09935d191f34a35d81cc0fbd58b035e6e5068efc/backend/open_webui/main.py#L185 Since it looks like you're using a docker image, just pass the env var `ENV=dev` and it should work, although I don't know if this will have other unintended consequences.

yindo commented

2026-02-15 17:05:29 -05:00

@adamoutler commented on GitHub (Oct 30, 2024):

The docs say the API should be in the code without qualifications. Also the code provides all the other documentation endpoints by default. I don't see anything suggesting this is a documentation error. If there is a change in progress, it's an incomplete code and documentation issue. Otherwise it's a code issue.

@adamoutler commented on GitHub (Oct 30, 2024): The docs say the API should be in the code without qualifications. Also the code provides all the other documentation endpoints by default. I don't see anything suggesting this is a documentation error. If there is a change in progress, it's an incomplete code and documentation issue. Otherwise it's a code issue.

yindo commented

2026-02-15 17:05:29 -05:00

@tjbck commented on GitHub (Nov 6, 2024):

ENV should be set to dev here to access the api documentations!

@tjbck commented on GitHub (Nov 6, 2024): `ENV` should be set to `dev` here to access the api documentations!

yindo commented

2026-02-15 17:05:30 -05:00

@adamoutler commented on GitHub (Nov 6, 2024):

Yes. That is the problem.

@adamoutler commented on GitHub (Nov 6, 2024): Yes. That is the problem.

yindo commented

2026-02-15 17:05:31 -05:00

@stephenjoly commented on GitHub (Mar 10, 2025):

I have no idea what im doing wrong but it seems like that doesnt do it for me. I tried to recreate the container. am i doing something wrong.

services:
openwebui:
container_name: openwebui
image: ghcr.io/open-webui/open-webui:main
restart: unless-stopped
environment:
- ENV=dev
- WEBUI_URL="https://genai.stephenjoly.net"
ports:
- "3000:8080"
volumes:
- ./appdata:/app/backend/data

I feel like ive tried everything and there's nothing left to try. hence my comment.

@stephenjoly commented on GitHub (Mar 10, 2025): I have no idea what im doing wrong but it seems like that doesnt do it for me. I tried to recreate the container. am i doing something wrong. services: openwebui: container_name: openwebui image: ghcr.io/open-webui/open-webui:main restart: unless-stopped environment: - ENV=dev - WEBUI_URL="https://genai.stephenjoly.net" ports: - "3000:8080" volumes: - ./appdata:/app/backend/data I feel like ive tried everything and there's nothing left to try. hence my comment.

yindo commented

2026-02-15 17:05:31 -05:00

@silentoplayz commented on GitHub (Nov 10, 2025):

https://docs.openwebui.com/getting-started/api-endpoints#swagger-documentation-links

@silentoplayz commented on GitHub (Nov 10, 2025): https://docs.openwebui.com/getting-started/api-endpoints#swagger-documentation-links

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: open-webui/docs#48