A cli tool to quickly create and manage nginx server blocks.

Usage no npm install needed!

<script type="module">
  import upServe from 'https://cdn.skypack.dev/up-serve';


quick nginx server blocks in one command


A quick demo

Current version: up v.0.3.1 (Alpha)

Notes: up is now in Alpha! 🎉 (Changelog)
⚠️ up is pretty useable so far. If you're testing up on a development server, do give us feedback.

up is a command line application that creates nginx server blocks quickly with a single command.


up currently supports nginx mainline and nginx stable on Linux based distros. Support for more distros will come soon. Add an issue to bump this process.

You will need to have node JS and nginx installed.

Install up from npm:

npm i -g up-serve

up is now available as a command.

Basic Commands

Format: up command <required> [optional]

  • up serve <domain> [outbound port] - Create new static server at current folder.
    • up static is deprecated from v. 0.2.5 (see changelog)
  • up proxy <domain> <inbound port> [outbound port] - Create new proxy server listening at said port.
  • up list - List currently available servers.
  • up kill <domain> - Kill the server for this domain.


  • up serve example.com will serve a static website from current folder.
  • up proxy example.com 8081 will create a reverse proxy listening at port 8081.
  • up kill example.com will kill the server named example.com.
  • up list will fetch a list of servers created with up.


const up = require('up-serve')

console.log(up.version()) // up v. 0.3.0

let result = up.server({ domain: "example.com", path: "path/to/project", outPort: "80" })
console.log(result) // Will log success or throw if error

let result = up.kill({ domain: "example.com", outPort: "80" })
console.log(result) // Will log success or throw if error

More detailed API documentation coming soon.



Contribution Guidelines

Contributors, Collaborators, and Guides