Table of Contents

Vagrant layer

Table of ContentsClose


1. Description

This layer adds support for working with Vagrant using vagrant.el and vagrant-tramp.

1.1. Features:

  • Manage boxes (under the SPC a t v prefix)
  • Remote editing on Vagrant boxes via Tramp

2. Install

2.1. Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add vagrant to the existing dotspacemacs-configuration-layers list in this file.

Note: Since vagrant files are written in ruby it is recommended to install the ruby layer as well.

2.2. Vagrant

Follow the Installing Vagrant and Getting Started guides in Vagrant's documentation.

2.3. Testing

If you'd like to test this layer out in a simple way (for example to make sure you have Vagrant configured correctly) there is a Vagrantfile in this directory.

3. Key bindings

Key binding Description
SPC a t v D destroy a box
SPC a t v e edit the Vagrantfile
SPC a t v H halt (shut down) a box
SPC a t v p (re)provision a box that is already up
SPC a t v r resume a suspended box (you can also use SPC V V for this)
SPC a t v R reload a box
SPC a t v s view the status of running boxes in the current project
SPC a t v S suspend a box
SPC a t v t start a vagrant-tramp-term session - after start, edit files at /vagrant:box_name:filename
SPC a t v V bring up a Vagrant box

Author: root

Created: 2024-04-03 Wed 19:40