Skip to main content
Deno 2 is finally here 🎉️
Learn more

It's a liver

Denoliver is a small, zero config static file server with live reloading written in TypeScript for Deno intended for prototyping and Single Page Applications.

Prerequisites

To run this you need to have Deno 1.0 or later installed.

Key Features

  • Dependency free! No third party dependencies.
  • Live reload of modified files.
  • Supports client side routing for Single Page Applications.
  • Directory lists
  • Supports HTTPS
  • Allows for programmatic use as a module
  • Boilerplating for rapid prototyping.

Directory Listing

Denoliver supports indexing of served directories and provides a simple interface, with dark mode support, for navigating a project folder.

Directory listing

Getting started

Install as a Deno executable.

NOTE: Deno is a secure runtime by default. You need to include the --allow-net, --allow-read and --allow-write flags to make sure Denoliver can serve your directory.

$ deno install --allow-net --allow-read --allow-write --allow-run https://deno.land/x/denoliver/mod.ts

or if you’re not happy with the name:

$ deno install -n whateverNameYouWant --allow-net --allow-read --allow-write --allow-run https://deno.land/x/denoliver/mod.ts

Why do I need the --allow-run flag?

You don’t need it! You can still use Denoliver as normal without this flag.

Currently Deno does not provide a way to access local network interfaces, so to do this you need to allow denoliver to spawn the subprocess ipconfig and fetch the address from there. When this implementation gets finished, this module will probably be deprecated.

This code is published for you to use here: https://github.com/joakimunge/deno-local-ip/

Running

From your project root / directory you want to serve

$ denoliver

Options

Denoliver comes with a couple of options to customize your experience.

-h                 # Help
-n                 # Disable live reload - Defaults to false
-s                 # Disable all output - Defaults to false
-p <PORT>          # Specify desired port - Defaults to 8080
-d                 # Debug for more verbose output - Defaults to false
-t                 # Use HTTPS - Requires a trusted self-signed certificate
-c                 # Use CORS - Defaults to false
--certFile=<..>    # Specify certificate file - Defaults to denoliver.crt
--keyFile=<..>     # Specify key file - Defaults to denoliver.key
--entry=<..>       # Specify optional entrypoint - Defaults to index.html

Optional boilerplating

If the given directory doesn’t exist, denoliver will ask you if you want to create a boilerplate. This will generate an a basic project folder and serve it for you. Very useful to get up and running quickly.

├── index.html
├── index.css
├── app.js

Configuration

If you want, you can place a configuration file called denoliver.json in the folder you are serving to avoid having to use command line arguments to customize its behaviour. By default it will look like this:

{
  "root": ".",
  "port": 8080,
  "disableReload": false,
  "silent": false,
  "debug": false,
  "secure": false,
  "cors": false,
  "certFile": "some_file.crt",
  "keyFile": "some_file.key",
  "entryPoint": "index.html"
}

API

Denoliver can also be used as a module in any Deno project. This exposes an instance of Deno.Server.

The main function accepts the same config object as specified in the config file above.

import denoliver from 'https://deno.land/x/denoliver/mod.ts'

const server = denoliver({ port: 6060, cors: true })

server.close() // Close the server

Serve over HTTPS

To use HTTPS you will need a trusted self-signed certificate. If you’re on macOS you can use This bash script to easily generate one.

Name the cert and key files denoliver.crt and denoliver.key and place them in your working dir. You can configure these names to be whatever you want with the config file, or the --certFile and --keyFile flags.

Disclaimer

This project is not intended for production use. It started out as a way for me personally to learn Deno, and is merely a tool to quickly get a file server up and running.

Acknowledgements

This project was heavily inspired by lukejacksonns fantastic Servor