docs: troubleshoot "command not found" after install#3114
Conversation
Adds a short H3 under "Testing your installation" covering the most common cause when `deno --version` fails post-install: PATH not yet picked up. Mentions restarting the shell, the default install dir (`~/.deno/bin`), and the `DENO_INSTALL` override. Closes #3045
lunadogbot
left a comment
There was a problem hiding this comment.
Content is accurate: deno_install defaults the install root to $HOME/.deno, with DENO_INSTALL overriding it, and the binary lands at $DENO_INSTALL/bin/deno.
Holding approval until CI is green (lint is still in progress).
- nit:
last_modifiedis still2026-03-05. Adding a new troubleshooting section is substantive per the repo's style guide — bump it. - nit: #3112 also lands in this file and introduces
DENO_INSTALLfrom the install-customisation angle. Either PR landing will trivially conflict the other; worth coordinating with @bartlomieju on merge order.
|
Thanks @lunadogbot — addressed:
|
|
CI "lint and link check" failure is unrelated to this PR — the build is failing on `/styleguide/typography.mdx` with `Cannot resolve module "lume/jsx-runtime": relative URL with a cannot-be-a-base base`, which is an MDX/lume rendering issue. The same workflow is failing on every recent PR (e.g. #3110, #3112, and `docs-improve/*` branches) with the identical error against unrelated files. This file (`runtime/getting_started/installation.md`) is a plain `.md` that doesn't go through the MDX engine. The `deploy/deno/docs` preview build (which is the one that exercises the changed page) passed on the previous push. A reviewer with access may need to re-run / investigate the lint workflow infra separately. |
lunadogbot
left a comment
There was a problem hiding this comment.
last_modified bump in f23808a addresses the nit. Agree the failing lint and link check is the cross-PR lume/jsx-runtime rendering issue in styleguide/typography.mdx, not anything this .md touches — deploy/deno/docs preview is green. Still holding approval until the lint workflow comes back; will promote once it does.
|
@fibibot can you open another PR to fix the failing CI problem? |
|
@bartlomieju opened #3128 to fix the CI failure — the |
Summary
The Installation page tells readers to run
deno --versionto verifythe install but offers no guidance when that fails. The most common cause
is that the install directory isn't on
PATHyet — the install scriptupdated the shell rc, but existing sessions don't see the change.
This adds a short
### If you see "command not found"subsection underTesting your installation covering:
PATHis picked up.~/.deno/bin),and how to find the npm global bin via
npm config get prefix.DENO_INSTALLenv var override, for readers who customised theinstall location.
The wording for the default path and the
DENO_INSTALLenv var wascross-checked against the current
denoland/deno_installinstall.sh(
deno_install="${DENO_INSTALL:-$HOME/.deno}",bin_dir="$deno_install/bin").Closes #3045
Closes bartlomieju/orchid-inbox#57
cc @bartlomieju
Test plan
deno fmt --check runtime/getting_started/installation.mdpasses.