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.
 
Muthu Kumar fa760dc8e3 [misc] fix: not requiring sudo for commands 7 years ago
.vscode CRLF to LF 7 years ago
actions BREAKING API Change. Functions accept objects instead of list of params. 7 years ago
assets Added demo gif to README 7 years ago
build Fixed wrong directory for default.conf 7 years ago
docs BREAKING API Change. Functions accept objects instead of list of params. 7 years ago
utils BREAKING API Change. Functions accept objects instead of list of params. 7 years ago
.eslintrc.json BREAKING API Change. Functions accept objects instead of list of params. 7 years ago
.gitignore BREAKING API Change. Functions accept objects instead of list of params. 7 years ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 7 years ago
Contributing.MD Rename docs/Contributing.MD to Contributing.MD 7 years ago
LICENSE Create LICENSE 7 years ago
README.md BREAKING API Change. Functions accept objects instead of list of params. 7 years ago
cli.js [misc] fix: not requiring sudo for commands 7 years ago
lib.js BREAKING API Change. Functions accept objects instead of list of params. 7 years ago
package-lock.json [misc] fix: not requiring sudo for commands 7 years ago
package.json [misc] fix: not requiring sudo for commands 7 years ago

README.md






quick nginx server blocks in one command






up

A quick demo

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

Roadmap

Contribution Guidelines

Contributors, Collaborators, and Guides