# 1- Working with vmr package

# The vmr package

## Presentation

The vmr package allow you to manage virtual environment with and for R.
You can develop, run tests, build packages binaries easily in a clean environment with R pre-installed and configured.

It uses Vagrant tool to manage this virtual environments, call boxes. A box is a Vagrant environment (bundle) containing a __virtual environment_ (such as a virtual machine) for a specific provider (such as VirtualBox).
Official vmr boxes list is available here : https://app.vagrantup.com/VMR/

> Boxes use default user and password: vagrant.
> Boxes are available for development and test, do not use it for production.

Take a quick overview from userR2022 poster presentation.

## Dependencies

The vmr package needs two tools to work Vagrant to manage boxes and a provider to instantiate the virtual environment.
* Vagrant (>= 2.2.0) : download and install from https://www.vagrantup.com/downloads.html.
* A provider, currently only VirtualBox (>= 6.1.14) is available in vmr boxes. Install it.

## Install

From CRAN:

    install.packages(c('vmr'))

From in development repository:

    remotes::install_git('https://gitlab.com/rstuff/vmr.git')

# Go further

1. Working with vmr package
2. Start my first environment
3. Manage vmr environment
4. Manage boxes
5. Manage providers
6. Development with vmr
7. CI/CD
8. Functions resume

### Next vignette : 2-Start my first environment