Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Setting up local-npm as a launch daemon on OS X

Setting up local-npm as a launch daemon on OS X

Update! There is now a script to do these steps for you.

These instructions will set up local-npm so that it runs as a launch daemon, meaning that it will start up whenever you log in.

First, install local-npm and pm2:

npm install -g local-npm
npm install -g pm2

Then choose a directory to store all the local-npm data:

mkdir ~/.local-npm

Next, make a plist file and save it as ~/Library/LaunchAgents/com.nolanlawson.localnpm.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "">
<plist version="1.0">

Make sure to replace YOUR_USERNAME above with your username.

Create a run script and save it as ~/.local-npm/ I also use nvm to choose my Node version:

#!/usr/bin/env bash

export PATH=$PATH:/usr/local/bin

# optional: set up nvm
export NVM_DIR="/Users/YOUR_USERNAME/.nvm"
[ -s "$NVM_DIR/" ] && . "$NVM_DIR/"  # This loads nvm
nvm use 4.0.0

pm2 start `which local-npm`

Make it runnable: chmod a+x ~/.local-npm/

Now, restart your machine or run:

launchctl load -w ~/Library/LaunchAgents/com.nolanlawson.localnpm.plist

Done! you can see the local-npm logs by running:

pm2 logs

You can also see the PouchDB Server Fauxton UI at http://localhost:16984/_utils, which is pretty fun.

Now just set npm to use your local-npm registry:

npm set registry

Or you can use npmrc to manage this.


This comment has been minimized.

Copy link

@jimpick jimpick commented Oct 4, 2015

It's also a good idea to go into Fauxton at http://localhost:16984/_utils and disable the Admin party.


This comment has been minimized.

Copy link
Owner Author

@nolanlawson nolanlawson commented Jan 4, 2016

@jimpick: Since PouchDB Server binds by default to, it's perfectly safe to run with the default settings. Unless you're worried someone will SSH tunnel into your machine, in which case it's already compromised. ;)


This comment has been minimized.

Copy link

@saeidzebardast saeidzebardast commented Jan 12, 2016

Thank you for this gist. I just updated it for Ubuntu users:
Setting up local-npm on OS X and Ubuntu


This comment has been minimized.

Copy link

@IngwiePhoenix IngwiePhoenix commented Jan 14, 2016

Would be nice to know how we can pass custom parameters - such as --remote - to local-npm using this demon. I had to google it, but it turns out pm2 allows that:

pm2 start `which local-npm` -- --remote

For whatever reason, using NPM over HTTPS and trying to punch 100+ requests to it, kills it O.o. That is why I need this flag.


This comment has been minimized.

Copy link

@rex rex commented Jan 19, 2016

@nolanlawson This is EPIC. Thank you so much for this write up. Following these steps exactly got me up and running in ~2 minutes. You rock.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment