denoland-deno/docs/examples/file_server.md

File server

Concepts

• Use the Deno standard library file_server.ts to run your own file server and access your files from your web browser.
• Run Deno install to install the file server locally.

Example

Serve a local directory via HTTP. First install the remote script to your local file system. This will install the script to the Deno installation root's bin directory, e.g. /home/alice/.deno/bin/file_server.

deno install --allow-net --allow-read https://deno.land/std@$STD_VERSION/http/file_server.ts

You can now run the script with the simplified script name. Run it:

$ file_server .
Downloading https://deno.land/std@$STD_VERSION/http/file_server.ts...
[...]
HTTP server listening on http://0.0.0.0:4507/

Now go to http://0.0.0.0:4507/ in your web browser to see your local directory contents.

Help

Help and a complete list of options are available via:

file_server --help

Example output:

Deno File Server
    Serves a local directory in HTTP.

  INSTALL:
    deno install --allow-net --allow-read https://deno.land/std/http/file_server.ts

  USAGE:
    file_server [path] [options]

  OPTIONS:
    -h, --help          Prints help information
    -p, --port <PORT>   Set port
    --cors              Enable CORS via the "Access-Control-Allow-Origin" header
    --host     <HOST>   Hostname (default is 0.0.0.0)
    -c, --cert <FILE>   TLS certificate file (enables TLS)
    -k, --key  <FILE>   TLS key file (enables TLS)
    --no-dir-listing    Disable directory listing

    All TLS options are required when one is provided.