Middleman

This is a generic Middleman engine used to launch Middleman apps on Microbox. 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 Microbox.

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 Microbox. If you need help with this engine, you can reach out to us in the Microbox Discord. If you are running into an issue with the engine, feel free to create a new issue on this project.