Skip to content

Latest commit

 

History

History
54 lines (27 loc) · 2.24 KB

README.md

File metadata and controls

54 lines (27 loc) · 2.24 KB

standby

Standby is an incredibly simple server that just delivers a page saying your site will be back shortly. That's all!

Use it in your deployment scripts to put up a placeholder page on the port number of your node app while you are migrating data or performing other tasks that can't be done while the site is up.

The standby page will automatically refresh until your site comes back.

The URL in the browser does not change, so the user typically gets the page they wanted once the site is back up.

How to Install

npm install -g standby

How to Use

To display a standby page on port 3000:

standby start 3000

To stop displaying a standby page on port 3000:

standby stop 3000

To substitute your own static content in place of our standby page:

standby start 3000 --content=/path/to/my/assets/folder

The page displayed to the user will be index.html in the content folder.

Note that you need to stop standby before launching your app again.

Standby uses files in /tmp/standby to keep track of what's already running. We use /tmp rather than /var/run because we hardly ever launch node apps as root.

Requirements

You need node and npm, of course. That's about it.

Standby and Stagecoach

Althogh you can use standby without it, we had stagecoach in mind when we wrote it. stagecoach makes it easy to deploy one or more node apps to an Ubuntu server without a lot of fuss. standby is a good companion piece for use during temporary downtime such as during data migration.

About P'unk Avenue and Apostrophe

standby was created at P'unk Avenue for use with sites built on Apostrophe, an open-source content management system built on node.js. If you like standby you should definitely check out apostrophenow.org. Also be sure to visit us on github.

Support

Feel free to open issues on github.