Contents

Install Nanobox

  • Mac
  • Linux
  • Windows

Note: There are known issues with installing and running Nanobox on MacOS 10.13 - High Sierra. For detailed instructions, view the Installing Nanobox on MacOS High Sierra article.

System Requirements

System requirements depend on how you're going to run Nanobox. You can either use a lightweight VM (VirtualBox) or Native Docker.

For MacOS, we recommend using the lightweight VM option. Docker's MacOS filesystem driver is slow.

Lightweight VM (VirtualBox)

netfs Requirements

During the intitial setup process, you'll specify how code is mounted into VM. "netfs" is the more performant option.

  • nfsd enabled and running

Native Docker

Download & Run the Nanobox Installer

Download the Nanobox installer from the Nanobox downloads page. Run it and it will walk you through the entire installation process.

Note: If you plan on going with the lightweight VM option and already have VirtualBox installed, you can select the "Use Docker Native" option. This will download an installer that only includes the Nanobox binary.

Run & Setup Nanobox

The first time you run any Nanobox command, it will walk you through an initial setup process to configure things like RAM, CPU, and other things related to your local environment.

Start Hacking!

With Nanobox installed, the Getting Started Guides walk you through getting popular languages and frameworks up and running with Nanobox.

System Requirements

Download the Nanobox Package

Download the Nanobox package appropriate for your Linux distribution from the Nanobox downloads page. Unpack and install the package as you normally install packages in your specific distro.

Run & Setup Nanobox

The first time you run any Nanobox command, it will walk you through an initial setup process specifying options for your local environment. The first question it will ask you is how you would like to run Nanobox. Select the Via Docker Native option.

Start Hacking!

With Nanobox installed, the Getting Started Guides walk you through getting popular languages and frameworks up and running with Nanobox.

System Requirements

  • Windows 10+
  • Nanobox may be able to run on Windows 7 and 8, but it is not tested, nor officially supported.

Other system requirements depend on how you're going to run Nanobox. You can either use a lightweight VM (VirtualBox) or Native Docker.

Lightweight VM (VirtualBox)

  • VirtualBox - A version of the Nanobox installer includes VirtualBox.
  • Hyper-V disabled

Native Docker

Download & Run Nanobox Installer

Download the Nanobox installer from the Nanobox downloads page. Run it and it will walk you through the entire installation process.

Note: If you plan on going with the lightweight VM option and already have VirtualBox installed, you can select the "Use Docker Native" option. This will download an installer that only includes the Nanobox executable.

Run & Setup Nanobox

The first time you run any Nanobox command, it will walk you through an initial setup process to configure things like RAM, CPU, and other things related to your local environment.

Start Hacking!

With Nanobox installed, our Getting Started Guides walk you through getting popular languages and frameworks up and running with Nanobox.

Reach out to help@nanobox.io and we'll try to help.