# Installing Nitro
# macOS and Linux
Install Multipass (opens new window) (requires 1.5.0+).
Run this terminal command:
bash <(curl -sLS https://raw.githubusercontent.com/craftcms/nitro/v1/install.sh)
Follow the prompts to create your machine.
# Windows 10 Pro (with Hyper-V enabled)
Windows doesn’t currently have an automated install script, so installation and updating must be done manually.
- Install Multipass (opens new window) (requires 1.5.0+).
nitro_windows_x86_64.zipfrom the latest release (opens new window)
- Create a
Nitrofolder in your home folder, if it does not exist. i.e.
- Extract the zip file and copy
Nitrofolder you just created in your home folder.
- If this is your first installation, run this from the command line to add
nitroto your global path:
setx path "%PATH%;%USERPROFILE%\Nitro"
- Start the Windows terminal (cmd.exe) with Administrator permissions and run
nitro initto create your first machine.
Once complete, you will have a Multipass machine called
nitro-dev, and a new configuration file for the machine stored at
# Uninstalling Nitro
To completely remove Nitro, first destroy your machine:
If you have multiple machines, you can destroy them all using the
multipass delete command:
multipass delete --all -p
Then remove your
You can optionally remove your machine configs as well:
If you wish to uninstall Multipass, uninstall instructions can be found on your platform’s installation guide: