Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
129 lines (86 sloc) 2.85 KB

Stonehenge

Stonehenge logo

Local development environment toolset on Docker supporting multiple projects.

Build Status

Requirements

  • macOS, Arch Linux or Ubuntu
  • Docker 17.04.0+
  • No other services listening port 80 or 443

Included containers

Setup

Note: in some systems setup will prompt once for your password as it will setup DNS.

Oneliner

$ sh -c "$(curl -fsSL https://raw.githubusercontent.com/druidfi/stonehenge/master/install.sh)"

Or manually with Git

$ git clone -b master https://github.com/druidfi/stonehenge.git ~/stonehenge
$ cd ~/stonehenge
$ make up

Local HTTPS

Requirements:

Create and install local CA and certs for Stonehenge:

$ make certs

Stop or shutdown Stonehenge

Note: Stonehenge will be started on boot by default if not stopped before.

To stop Stonehenge:

$ make stop

Or totally to stop and remove Stonehenge:

$ make down

Add alias

Add this line to your shell (bash, zsh, fish):

alias stonehenge='make -C ~/stonehenge'

Now you can run make targets from anywhere with the alias:

$ stonehenge up

Example applications

Tested with

  • Arch Linux
  • macOS High Sierra 10.13.6
  • macOS Mojave 10.14
  • Manjaro 17.1.6 (Arch Linux)
  • Ubuntu 16.04
  • Ubuntu 17.10
  • Ubuntu 18.04

Fork and modify

To brand the toolset for your organization:

  • Fork this repository
  • Modify .env file e.g. like follows:
    • COMPOSE_PROJECT_NAME=company_dev
    • DOCKER_DOMAIN=docker.company_dev.com
    • LOGO_URL=https://your-cool-logo.png
    • NETWORK_NAME=company_dev-network
    • PREFIX=company_dev
  • IMPORTANT! Let us know! <3

TODO

  • More examples
  • Shell detection and autocreate the alias

References

License

The files in this archive are released under the MIT license. You can find a copy of this license in LICENSE.

You can’t perform that action at this time.