Skip to content

docs: add VITE_API_BASE_URL for remote/VPS deployment#554

Open
JiayuuWang wants to merge 1 commit into666ghj:mainfrom
JiayuuWang:contribot/remote-deploy-docs
Open

docs: add VITE_API_BASE_URL for remote/VPS deployment#554
JiayuuWang wants to merge 1 commit into666ghj:mainfrom
JiayuuWang:contribot/remote-deploy-docs

Conversation

@JiayuuWang
Copy link
Copy Markdown

Summary

  • Document VITE_API_BASE_URL environment variable for remote/VPS deployment
  • Added remote deployment notes to README.md and README-ZH.md
  • Users accessing MiroFish remotely (not on localhost) will now be able to configure the API endpoint

Changes

  • .env.example - Added VITE_API_BASE_URL with explanation
  • README.md - Added "Remote/VPS Deployment Note" section
  • README-ZH.md - Added Chinese version of remote deployment note

Why

When deploying MiroFish on a VPS and accessing remotely, users get "Network error" because the axios client defaults to http://localhost:5001. The Vite dev server proxy only works locally.

Document how to configure frontend-backend communication for remote access.
The Vite dev server proxy (/api -> localhost:5001) only works in local development.
When deploying on a VPS or accessing from a different machine, users must set
VITE_API_BASE_URL to the server's actual IP/URL.

Changes:
- Add VITE_API_BASE_URL to .env.example with usage instructions
- Add remote deployment note to README.md (English)
- Add remote deployment note to README-ZH.md (Chinese)
@dosubot dosubot Bot added size:S This PR changes 10-29 lines, ignoring generated files. documentation Improvements or additions to documentation labels Apr 20, 2026
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:S This PR changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant