Skip to content

Latest commit

 

History

History
78 lines (57 loc) · 2 KB

README.md

File metadata and controls

78 lines (57 loc) · 2 KB
Raw

Middleman

This is a generic Middleman engine used to launch Middleman apps on Nanobox. The engine automatically creates a web component named web.middleman that includes an Nginx webserver. The engine auto-detects your Middleman build_dir specified in your config.rb.

Usage

To use this engine, specify the engine in your boxfile.yml:

run.config:
  engine: middleman

Build Process

  • bundle install
  • bundle clean
  • bundle exec middleman build

Basic Configuration Options

This engine exposes configuration options through the boxfile.yml, a yaml config file used to provision and configure your app's infrastructure when using Nanobox.

Overview of Basic Boxfile Configuration Options

run.config:
  # Ruby Settings
  ruby_runtime: ruby-2.2

  # Nginx Settings
  force_https: false
Quick Links

Ruby Settings
Web Server Settings

Ruby Settings

The following setting allows you to define your Middleman runtime environment.

ruby_runtime

Specifies which Middleman runtime and version to use. The following runtimes are available:

  • ruby-1.9
  • ruby-2.0
  • ruby-2.1
  • ruby-2.2 (default)
  • ruby-2.3
  • jruby-1.6
  • jruby-1.7
  • jruby-9.0
run.config:
  engine.config:
    ruby_runtime: 'ruby-2.2'

Web Server Settings

The following setting is used to configure Nginx in your application.

force_https

Forces all incoming web requests to use https.

run.config:
  engine.config:
    force_https: false

Help & Support

This is a generic (non-framework-specific) Middleman engine provided by Nanobox. If you need help with this engine, you can reach out to us in the #nanobox IRC channel. If you are running into an issue with the engine, feel free to create a new issue on this project.