---
id: molecule-vagrant
version: "2.0.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# molecule-vagrant — Vagrant Molecule Plugin :: run molecule tests using Vagrant

License: permissive · Maintenance: abandoned · Downloads: 525.6K/mo

## What it is and what it does

Molecule Vagrant Plugin is a driver for the Molecule testing framework that uses Vagrant to provision and manage test instances. It allows developers to define test scenarios in molecule.yml that spin up virtual machines via Vagrant (supporting providers like VirtualBox, libvirt, and Parallels) and then run Molecule's test sequence against those instances.

The plugin integrates Vagrant's configuration model directly into Molecule, letting you specify box images, network interfaces, resource allocation, and raw Vagrant provisioning directives. It depends on molecule, python-vagrant for Vagrant CLI interaction, and standard Python libraries like pyyaml and Jinja2 for configuration templating. The package requires Python 3.9 or later and is known to work on macOS with VirtualBox and Fedora/Ubuntu with libvirt, though Vagrant's CLI installation can be problematic on some platforms.

Use it for:

- Test Ansible roles and playbooks across multiple OS distributions by defining Vagrant boxes in molecule.yml
- Set up multi-node test environments with custom networking, forwarded ports, and synced folders for integration testing
- Run Molecule tests locally on developer machines using VirtualBox or on CI systems with libvirt
- Configure raw Vagrant provisioning steps and provider-specific options directly within Molecule scenarios

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Molecule Vagrant Plugin enables Vagrant-based provisioning and testing of infrastructure for Ansible molecule test scenarios, integrating Vagrant as a driver for test resource orchestration.

No. The package is abandoned (last release 2023-01-06, repository archived) with no maintenance for 1316 days. While it carries no known vulnerabilities and has permissive licensing, the lack of updates means it will not track Molecule, Ansible, or Vagrant ecosystem changes. Use only if locked into an existing project already using this version.

## Install

pip install molecule-vagrant
uv add molecule-vagrant
poetry add molecule-vagrant

## Installing molecule-vagrant

Before you install: Low install friction with a pure-Python wheel distribution. However, the package is abandoned as of January 2023 with no recent maintenance; the underlying Vagrant CLI dependency is known to have platform-specific installation issues on some systems.

License in practice: MIT license is permissive and imposes no restrictions on use, modification, or distribution in proprietary or open-source contexts.

Quickstart:

pip install molecule-vagrant

In molecule.yml:
driver:
  name: vagrant
platforms:
  - name: instance
    box: fedora/32-cloud-base
    memory: 512
    cpus: 1

Requires Vagrant CLI to be installed and functional on the host system; Vagrant installation is known to be problematic on some platforms including CentOS 8.

Verify before relying:

- Compatibility with recent Molecule and Ansible versions given the January 2023 last release
- Status of the five runtime dependencies in current ecosystems
- Whether the package works with modern Vagrant versions and providers

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 525.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vagrant molecule testing, ansible test provisioning vagrant, molecule vagrant driver, infrastructure testing ansible, vagrant test orchestration, ansible role testing vagrant, molecule infrastructure provisioning, ansible-testing, vagrant-integration, abandoned

[View on SkillFed](https://skillfed.io/packages/molecule-vagrant) · [View on PyPI](https://pypi.org/project/molecule-vagrant/)