A bedrock module that provides a basic HTTP and HTTPS server. Other modules, such as bedrock-express, typically provide a routing framework and other features for writing Web applications, but depend on this module for core low-level functionality like listening for incoming connections, redirecting HTTP traffic to the HTTPS port, and configuring SSL/TLS.
- npm v3+
npm install bedrock-server
An example of attaching a custom request handler to the server once Bedrock is ready.
var bedrock = require('bedrock');
var server = require('bedrock-server');
// once bedrock is ready, attach request handler
bedrock.events.on('bedrock.ready', function() {
// attach to TLS server
server.servers.https.on('request', function(req, res) {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello World\n');
});
});
bedrock.start();
By default, bedrock-server
will redirect any HTTP requests to HTTPS. To
replace this default behavior, do the following:
var server = require('bedrock-server');
// once bedrock is ready, attach request handler
bedrock.events.on('bedrock.ready', function() {
// attach to HTTP server
server.servers.http.on('request', function(req, res) {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello World\n');
});
});
bedrock.start();
For documentation on server configuration, see config.js.
- [optional] Tweak configuration
- Map the
bedrock.dev
hostname (or whatever you've configured) to your machine:- Edit the /etc/hosts file as the administrator/root.
- Add an entry mapping the IP address to
bedrock.dev
. For example:192.168.0.15 bedrock.dev
(where192.168.0.15
is the IP address of your primary network device).
To access the server once bedrock is running:
- Go to: https://bedrock.dev:18443/
- The certificate warning is normal for development mode. Accept it and continue.
TODO