A cli tool to quickly create and manage nginx server blocks. https://up.js.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 

2.4 KiB






quick nginx server blocks in one command






up

A quick demo

Current version: up v.0.2.5 (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.

Installation

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.

Examples

  • up static 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.

API

const up = require('up-serve')

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

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

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

More detailed API documentation coming soon.


Meta

Roadmap

Contribution Guidelines

Contributors, Collaborators, and Guides