Installing #

For an app in your current directory:

npm install deployd express socket.io

Hello World #

Here is a simple hello world using Deployd as an express middleware.

// hello-server-attach.js
var PORT = process.env.PORT || 3000;
var ENV = process.env.NODE_ENV || 'development';

// setup http + express + socket.io
var express = require('express');
var app = express();
var server = require('http').createServer(app);
var io = require('socket.io').listen(server, {'log level': 0});

// setup deployd
require('deployd').attach(server, {
    socketIo: io,  // if not provided, attach will create one for you.
    env: ENV,
    db: {host:'localhost', port:27017, name:'test-app'}
});

// After attach, express can use server.handleRequest as middleware
app.use(server.handleRequest);

// start server
server.listen(PORT);

Run this like any other express server.

node hello-server-attach.js

Caveats #

• Deployd mounts its server on process.server. This means you can only run one Deployd server in a process.
• Deployd loads resources from the process.cwd. Add this to ensure you are in the right directory: process.chdir(__dirname).
• In order to access the /dashboard without a key you must run Deployd with the env option set to development.