node-launchd

    0.0.3 • Public • Published

    node-launchd

    A Node.js Addon to get sockets from launchd upon (port-activated) launching on osx

    Usage

    Suppose, you created an app using express in directory

    /Users/you/Projects/yourapp
    

    , and your node installation lives in

    /Users/you/Applications/Node.app/Contents
    

    and you want your app to use port 8080.

    First, create a launchd configuration file (e.g., yourapp.plist) in

    ~/Library/LaunchAgents
    

    , fill it with content such as this

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
    	<key>Label</key>
    	<string>org.something.yourapp</string>
    	<key>EnvironmentVariables</key>
    		<dict>
    			<key>NODE_PATH</key>
    			<string>/Users/you/Applications/Node.app/Contents/lib/node_modules</string>
    		</dict>
    	<key>ProgramArguments</key>
    	<array>
    		<string>/Users/you/Applications/Node.app/Contents/bin/node</string>
    		<string>/Users/you/Projects/yourapp/app.js</string>
    	</array>
    	<key>Sockets</key>
    	<dict>
    		<key>HTTPSocket</key>
    		<dict>
    			<key>SockFamily</key>
    			<string>IPv4</string>
    			<key>SockServiceName</key>
    			<string>8080</string>
    			<key>SockType</key>
    			<string>stream</string>
    			<key>SockPassive</key>
    			<string>false</string>
    		</dict>
    	</dict>
    </dict>
    </plist>
    

    change the app.js file in you project directory to start the http server using a launchd file handle like this

    http.createServer(app).listen({fd:require('node-launchd').getSocketFileDescriptorForName('HTTPSocket')});
    

    Finally, you can load the launchd configuration file like this

    launchctl load -w ~/Library/LaunchAgents/yourapp.plist
    

    Keywords

    none

    Install

    npm i node-launchd

    DownloadsWeekly Downloads

    2

    Version

    0.0.3

    License

    none

    Last publish

    Collaborators

    • little-big-h