/innervate

Procfile based pow alternative

Primary LanguageGoApache License 2.0Apache-2.0

Innervate

A development oriented proxy server based off of procfiles and multicast dns. Inspired by Pow.

Installation

From Source (OSX)

  1. Install Go and set up your $GOPATH
  2. Clone this repo
  3. Run bash __support__/install.sh

Usage

Symlink any application that has a procfile (or a config.ru) into the configuration directory.

$ ln -s <project_path> /usr/local/etc/innervate/my-app-name

Navigate to your application

$ open http://my-app-name.localhost/

Configuration options

Innervate uses system links manage the applications being served. It supports the following flags to configure global behavior. To use these flags, edit Innervate’s init script (plist/systemd unit/etc) and relaunch the binary via your initd.

-config

The location of the configuration directory. Defaults to /usr/local/etc/innervate.

-port

The port to run the proxy on. For development purposes, it defaults to 8080 but default installations should set it to 80.

-restart

Whether to terminate in a way to have the initd restart Innervate. Defaults to false for development, but default installations should set it to true

-start-port

The port to start at when assigning ports for hosted services. Defaults to 10000.

-tld

The top level domain to use for DNS entries. Per RFC 2606 this defaults to localhost.

License

Copyright 2016 Hunter Madison

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.