Neap Box

A Vagrant box for Neap development.

Read me first

This project aims to give you the necessary tools to build yourself the Neap Box.
Note: If you only intend to use the Neap Box, you will never have to build it yourself! Instead, get it from:

• GitHub releases
• Atlas by HashiCorp

About

Version: 1.4.1-dev
Web: Coming later, box.neap.io
Project Owner: Michaël "e7d" Ferrand

Prerequisites

In order to build the Neap Box effectively, you'll need to have a few tools installed:

1. Install Git
2. Install VirtualBox
3. Install Vagrant

Windows-specific

1. Add the Git binaries to your path

Recommended

1. Use a development workstation with at least 2 cores and 8GB of RAM, as Vagrant should be allocated 1GB of RAM
2. Install Vagrant::VBGuest, to manage the host's VirtualBox Guest Additions on the guest system
   vagrant plugin install vagrant-vbguest

Build

1. git clone https://github.com/e7d/neap-box.git to clone the latest version
2. Change into the directory neap-box
3. Run vagrant up
4. Run vagrant package --output neap.box

Note: Steps 3. and 4. can be replaced with a call to build.sh on bash available environments.

What you get

After the build process is done, you have a file named neap.box that can be imported in Vagrant or VirtualBox.

Software stack

Neap box uses Vagrant's shell provisioner over a large collection of scripts to kick things off.

Once Vagrant is done provisioning the VM, you will have a box containing:

• Debian Jessie 8.8, as operating system, with:
  • VirtualBox Guest Additions 5.1.22
• Let's Encrypt Certbot 0.14.1, as SSL certificate generator
• jq 1.5, as JSON processor
• PostgreSQL 9.6.3, as database system
• Redis 3.2.9, as data structure store
• MailCatcher 0.6.5 as mail catching server
• nginx 1.13.0, as web server, with:
  • OpenSSL 1.1.0e, as SSL module
  • nginx-rtmp-module 1.1.11, as streaming handler (RTMP, HLS and DASH protocols)
• PHP 7.1.5, as server-side scripting language, with:
  • PHP-FPM 7.1.5, as PHP process manager
  • PhpRedis 3.1.2, as PHP extension for Redis
  • Xdebug 2.5.1, as debugger and profiler tool
  • Composer 1.4.2, as dependency manager
• NodeJS 6.10.3, as JavaScript runtime
  • NPM 4.6.1, as JavaScript package manager
  • Newman 3.6.0, as Postman collection runner
• Yarn 0.24.5, as dependency manager
• FFmpeg 2.8.11, as media converter
• UnrealIRCd 4.0.12, as IRC server daemon, with:
  • Anope 2.0.5, as IRC services daemon