logo

D3nver helper application

Requirements

For now, D3nver only supports VirtualBox 6 as a provider so please make sure to have VirtualBox 6+ running on your computer.

For Windows users, you must add VirtualBox to your PATH system environment variable. You can find the procedure here: https://www.build-business-websites.co.uk/add-vboxmanage-to-path

Getting started

Download and uncompress the release anywhere on your computer then, open a terminal (you can use Powershell for Windows users) in this directory.

./denver
D3nver, the Developer ENVironment

Usage:
  denver [command]

Available Commands:
  help        Help about any command
  init        Init the instance
  ssh         Connect through ssh in a local terminal
  start       Start the instance
  status      Check if the instance is ready to operate
  stop        Stop the instance
  term        Connect through the configured terminal

Flags:
      --config string   config file (default is ./conf/config.yml)
  -h, --help            help for denver
      --version         version for denver

Use "denver [command] --help" for more information about a command.

Set your configuration file

Rename or copy the config.yml.dist to config.yml in the conf folder. Take time to adjust your settings in the conf/config.yml file, especially :

Initialize your instance

Once your configuration file is ready, get into the D3nver folder and open a terminal :

# Mac/Linux users
./denver init

# Windows users
denver.exe init

In this phase, the denver will :

You have to perform this operation just once.

Start your instance

Once the D3nver instance has been initialized, you can start it :

# Mac/Linux users
./denver start

# Windows users
denver.exe start

Connect to D3nver

Through SSH

There are many ways to connect to the D3nver instance through SSH. First, if you provided the path to your SSH key in the config.yml file, it had been pushed and authorized inside the instance so that you can connect from your terminal passwordless.

denver also provide 2 alternative ways to connect to the instance.

# connect with your terminal and SSH key
ssh ldevuser@10.10.10.10

# ----------------------------------------------------------------------------

# connect with denver and the configured terminal from config.yml (Mac/Linux)
./denver term

# connect with denver and the configured terminal from config.yml (Windows)
denver.exe term

# ----------------------------------------------------------------------------

# connect with denver with the current terminal (Mac/Linux)
./denver ssh

# connect with denver with the current terminal (Windows)
denver.exe ssh

Shared volume

Working with D3nver means storing your source files inside the D3nver instance itself and not on your local workstation. However, that doesn’t mean that you can’t use your preferred local IDE or editor. Inside the D3nver instance, there is a Projects folder, and this is the place where your sources should be stored. This folder is shared with your workstation through multiple protocols depending on your operating system, and you can choose the best fit :