deno run, run a file

deno run [OPTIONS] [SCRIPT_ARG]...

deno run https://examples.deno.land/hello-world.ts

deno run --allow-read --allow-net jsr:@std/http/file-server

deno run --allow-read=/etc jsr:@std/http/file-server

deno run -A jsr:@std/http/file-server

curl https://examples.deno.land/hello-world.ts | deno run -

Type checking options Jump to heading#

--check Jump to heading#

Enable type-checking. This subcommand does not type-check by default If the value of "all" is supplied, remote modules will be included. Alternatively, the 'deno check' subcommand can be used.

--no-check Jump to heading#

Skip type-checking. If the value of "remote" is supplied, diagnostic errors from remote modules will be ignored.

Dependency management options Jump to heading#

--cached-only Jump to heading#

Require that remote dependencies are already cached.

--frozen Jump to heading#

Error out if lockfile is out of date.

--import-map Jump to heading#

Load import map file from local file or remote URL.

--lock Jump to heading#

Check the specified lock file. (If value is not provided, defaults to "./deno.lock").

--no-lock Jump to heading#

Disable auto discovery of the lock file.

--no-npm Jump to heading#

Do not resolve npm modules.

--no-remote Jump to heading#

Do not resolve remote modules.

--node-modules-dir Jump to heading#

Sets the node modules management mode for npm packages.

--reload Jump to heading#

Short flag: -r

Reload source code cache (recompile TypeScript) no value Reload everything jsr:@std/http/file-server,jsr:@std/assert/assert-equals Reloads specific modules npm: Reload all npm modules npm:chalk Reload specific npm module.

--vendor Jump to heading#

Toggles local vendor folder usage for remote modules and a node_modules folder for npm packages.

Options Jump to heading#

--cert Jump to heading#

Load certificate authority from PEM encoded file.

--config Jump to heading#

Short flag: -c

Configure different aspects of deno including TypeScript, linting, and code formatting Typically the configuration file will be called deno.json or deno.jsonc and automatically detected; in that case this flag is not necessary.

--env-file Jump to heading#

Load environment variables from local file Only the first environment variable with a given key is used. Existing process environment variables are not overwritten.

--ext Jump to heading#

Set content type of the supplied file.

--location Jump to heading#

Value of globalThis.location used by some web APIs.

--no-code-cache Jump to heading#

Disable V8 code cache feature.

--no-config Jump to heading#

Disable automatic loading of the configuration file.

--seed Jump to heading#

Set the random number generator seed.

--v8-flags Jump to heading#

To see a list of all available flags use --v8-flags=--help Flags can also be set via the DENO_V8_FLAGS environment variable. Any flags set with this flag are appended after the DENO_V8_FLAGS environment variable.

Debugging options Jump to heading#

--inspect Jump to heading#

Activate inspector on host:port [default: 127.0.0.1:9229]

--inspect-brk Jump to heading#

Activate inspector on host:port, wait for debugger to connect and break at the start of user script.

--inspect-wait Jump to heading#

Activate inspector on host:port and wait for debugger to connect before running user code.

File watching options Jump to heading#

--hmr Jump to heading#

Watch for file changes and restart process automatically. Local files from entry point module graph are watched by default. Additional paths might be watched by passing them as arguments to this flag.

--no-clear-screen Jump to heading#

Do not clear terminal screen when under watch mode.

--watch Jump to heading#

Watch for file changes and restart process automatically. Local files from entry point module graph are watched by default. Additional paths might be watched by passing them as arguments to this flag.

--watch-exclude Jump to heading#

Exclude provided files/patterns from watch mode.

Usage Jump to heading#

To run the file at https://docs.deno.com/examples/hello-world.ts use:

deno run https://docs.deno.com/examples/hello-world.ts

You can also run files locally. Ensure that you are in the correct directory and use:

deno run hello-world.ts

By default, Deno runs programs in a sandbox without access to disk, network or ability to spawn subprocesses. This is because the Deno runtime is secure by default. You can grant or deny required permissions using the --allow-* and --deny-* flags.

Permissions examples Jump to heading#

Grant permission to read from disk and listen to network:

deno run --allow-read --allow-net server.ts

Grant permission to read allow-listed files from disk:

deno run --allow-read=/etc server.ts

Grant all permissions this is not recommended and should only be used for testing:

deno run -A server.ts

If your project requires multiple security flags you should consider using a deno task to execute them.

Watch Jump to heading#

To watch for file changes and restart process automatically use the --watch flag. Deno's built in application watcher will restart your application as soon as files are changed.

Be sure to put the flag before the file name eg:

deno run --allow-net --watch server.ts

Deno's watcher will notify you of changes in the console, and will warn in the console if there are errors while you work.

Running a package.json script Jump to heading#

package.json scripts can be executed with the deno task command.

Running code from stdin Jump to heading#

You can pipe code from stdin and run it immediately with:

curl https://docs.deno.com/examples/hello-world.ts | deno run -

Terminate run Jump to heading#

To stop the run command use ctrl + c.