Skip to content

docs: add VITE_API_BASE_URL documentation for remote/VPS deployment#516

Open
harshitanand wants to merge 1 commit into666ghj:mainfrom
harshitanand:docs/issue-514-vite-api-base-url-vps
Open

docs: add VITE_API_BASE_URL documentation for remote/VPS deployment#516
harshitanand wants to merge 1 commit into666ghj:mainfrom
harshitanand:docs/issue-514-vite-api-base-url-vps

Conversation

@harshitanand
Copy link
Copy Markdown

What

Users deploying MiroFish on a remote VPS see a "Network error" at step 1/5 because the Vite dev proxy only works locally — remotely, the browser tries to reach localhost:5001 on the user's own machine instead of the server.

This PR documents the VITE_API_BASE_URL fix that resolves it.

Changes

  • .env.example — adds commented-out VITE_API_BASE_URL variable with a clear explanation of when and why to set it
  • README.md (Chinese) — adds a ⚠️ Remote/VPS Deployment Note section after the Docker deployment block
  • README-EN.md (English) — adds the equivalent section in English

Testing

Related

Closes #514
Also resolves the root cause reported in #511

@dosubot dosubot bot added size:M This PR changes 30-99 lines, ignoring generated files. documentation Improvements or additions to documentation labels Apr 10, 2026
…66ghj#514)

When MiroFish is deployed on a remote VPS the Vite dev proxy is not
active in the browser, so axios defaults to localhost:5001 on the user's
own machine causing a network error on the frontend.

Document the VITE_API_BASE_URL fix in three places:
- .env.example: add commented-out variable with explanation
- README.md (Chinese): add VPS deployment note after Docker section
- README-EN.md (English): add equivalent note in English

Closes 666ghj#511 (same root cause confirmed by multiple users).
@harshitanand harshitanand force-pushed the docs/issue-514-vite-api-base-url-vps branch from 803872e to 1b9cd10 Compare April 10, 2026 08:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add VITE_API_BASE_URL documentation for remote/VPS deployment

1 participant