Skip to content

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

License

Notifications You must be signed in to change notification settings

codefeathers/up-serve

Repository files navigation






quick nginx server blocks in one command






up

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.

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 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.

API

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.


Meta