Skip to content

docs: add installer environment variables documentation#2114

Merged
fengmk2 merged 5 commits into
voidzero-dev:mainfrom
yukinoshi:docs/issue-1957-installer-env-vars
Jul 10, 2026
Merged

docs: add installer environment variables documentation#2114
fengmk2 merged 5 commits into
voidzero-dev:mainfrom
yukinoshi:docs/issue-1957-installer-env-vars

Conversation

@yukinoshi

Copy link
Copy Markdown
Contributor
  • Create docs/guide/installer-env-vars.md documenting env vars used by installers (vp-setup.exe, install.ps1, install.sh)
  • Add links from Getting Started, Environment, Install, Docker, and Upgrade
  • Cover install vars (VP_VERSION, VP_HOME, NPM_CONFIG_REGISTRY, VP_NODE_MANAGER, VP_PR_VERSION, etc.)
  • Cover runtime vars (VP_HOME, VP_NODE_DIST_MIRROR, VP_NODE_VERSION, VP_DEBUG_SHIM, etc.)
  • Cover TLS/CA config (SSL_CERT_FILE, NODE_EXTRA_CA_CERTS, VP_INSECURE_TLS)
  • Cover logging/debug vars (VITE_LOG, VITE_UPDATE_TASK_TYPES, etc.)
  • Document standard vars (CI, NO_COLOR, HOME) and precedence rules

Closes #1957

- Create docs/guide/installer-env-vars.md documenting env vars used by
  installers (vp-setup.exe, install.ps1, install.sh)
- Add links from Getting Started, Environment, Install, Docker, and Upgrade
- Cover install vars (VP_VERSION, VP_HOME, NPM_CONFIG_REGISTRY,
  VP_NODE_MANAGER, VP_PR_VERSION, etc.)
- Cover runtime vars (VP_HOME, VP_NODE_DIST_MIRROR, VP_NODE_VERSION,
  VP_DEBUG_SHIM, etc.)
- Cover TLS/CA config (SSL_CERT_FILE, NODE_EXTRA_CA_CERTS, VP_INSECURE_TLS)
- Cover logging/debug vars (VITE_LOG, VITE_UPDATE_TASK_TYPES, etc.)
- Document standard vars (CI, NO_COLOR, HOME) and precedence rules

Closes voidzero-dev#1957
@netlify

netlify Bot commented Jul 9, 2026

Copy link
Copy Markdown

Deploy Preview for viteplus-preview ready!

Name Link
🔨 Latest commit cfb6250
🔍 Latest deploy log https://app.netlify.com/projects/viteplus-preview/deploys/6a50df83e9ebb80008da4687
😎 Deploy Preview https://deploy-preview-2114--viteplus-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5719297066

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/guide/installer-env-vars.md Outdated
Comment thread docs/guide/env.md Outdated
Comment thread docs/guide/install.md Outdated
@yukinoshi yukinoshi mentioned this pull request Jul 9, 2026
4 tasks
@yukinoshi

Copy link
Copy Markdown
Contributor Author

Got it, thanks for clarifying. I removed those extra hint/tip additions from unrelated pages and kept the changes focused on the new installer environment variables document.

@yukinoshi yukinoshi requested a review from fengmk2 July 10, 2026 02:48

@fengmk2 fengmk2 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@yukinoshi Thanks

@yukinoshi

Copy link
Copy Markdown
Contributor Author

Thanks for letting me be a part of it, it was an awesome experience, thank you all

@yukinoshi yukinoshi closed this Jul 10, 2026
@fengmk2

fengmk2 commented Jul 10, 2026

Copy link
Copy Markdown
Member

@yukinoshi why close it?

@yukinoshi yukinoshi reopened this Jul 10, 2026
@fengmk2

fengmk2 commented Jul 10, 2026

Copy link
Copy Markdown
Member

@yukinoshi can you fix the doc format check erros? Thanks.

@yukinoshi

Copy link
Copy Markdown
Contributor Author

@yukinoshi why close it?

Clicked it by accident

@yukinoshi

Copy link
Copy Markdown
Contributor Author

@yukinoshi can you fix the doc format check erros? Thanks.

ok

@yukinoshi

Copy link
Copy Markdown
Contributor Author

@fengmk2 Done. The formatting issue was caused by my outdated branch and should be fixed now. Could you please check it again? Thanks!

@fengmk2

fengmk2 commented Jul 10, 2026

Copy link
Copy Markdown
Member

@yukinoshi let me fix format issue before I merge.

- Fix trailing whitespace in docker.md (vp fmt --check failure)
- Merge the duplicate VP_HOME entries into one
- Link the canonical sections for VP_PR_VERSION, VP_NODE_DIST_MIRROR,
  and VP_NODE_SKIP_SIGNATURE_VERIFY instead of restating them
- Drop VITE_UPDATE_TASK_TYPES (test-time codegen switch; the documented
  vp update command does not exist), VP_TRAMPOLINE_PATH (test-only),
  VP_ENV_USE_EVAL_ENABLE and VITE_GLOBAL_CLI_JS_SCRIPTS_DIR (internal/dev)
- Compress the internal-variable lists and dev-only installer vars to
  short notes; merge SSL_CERT_FILE / NODE_EXTRA_CA_CERTS
- Register the page in the sidebar next to Environment and replace the
  Getting Started info box with a plain sentence
@fengmk2 fengmk2 merged commit 0a767d6 into voidzero-dev:main Jul 10, 2026
38 of 40 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document installer env variables

2 participants