Skip to main content
Documentation Configuration Customize Your Site

Web Server Configuration

Bridgetown requires a Rack-compliant web server, (along with Roda) for serving up statically-built files as well as any dynamic routes. The default server is Falcon, but we also natively support Puma.

In development (bin/bridgetown start), Bridgetown uses Rackup to start the web server. Since this is a generic interface, the configuration options are limited. By default, Bridgetown serves over HTTP via port 4000, bound to 0.0.0.0 (this makes it accessible via localhost as well as the network).

You can change the port using -P:

$ bin/bridgetown start -P 6000

And, to change the IP address to something other than 0.0.0.0, provide a --bind / -B argument:

$ bin/bridgetown start -B 192.168.1.1

In production, use your server’s command line program to start it directly. Bridgtown creates a configuration file for your chosen web server in the config/ folder. Use this to customize your deployment and refer to your chosen server’s documentation for further information.

Back to Customize Your Site