PHPackages                             vube/vagrant-boxer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. vube/vagrant-boxer

ActiveProject[DevOps & Deployment](/categories/devops)

vube/vagrant-boxer
==================

Create re-usable base boxes for Vagrant

0.6.1(11y ago)192123MITPHPPHP >=5.3.2

Since Apr 30Pushed 11y ago2 watchersCompare

[ Source](https://github.com/vube/vagrant-boxer)[ Packagist](https://packagist.org/packages/vube/vagrant-boxer)[ RSS](/packages/vube-vagrant-boxer/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependencies (4)Versions (12)Used By (0)

Vagrant Boxer
=============

[](#vagrant-boxer)

[![Build Status](https://camo.githubusercontent.com/eda2d54fbbcd3d868359d80a69fbde743b7cfdc14c79c800e9cf973024221008/68747470733a2f2f7472617669732d63692e6f72672f767562652f76616772616e742d626f7865722e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/vube/vagrant-boxer)[![Coverage Status](https://camo.githubusercontent.com/407bb7e2e98b9903b595492ada9ab169cc2f9f55c671005ba1c91a52aceff599/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f767562652f76616772616e742d626f7865722f62616467652e706e673f6272616e63683d6d6173746572)](https://coveralls.io/r/vube/vagrant-boxer?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/83d570a7031a59391d109eb436f3800ac279c8749714ab67e5af16506c083d7b/68747470733a2f2f706f7365722e707567782e6f72672f767562652f76616772616e742d626f7865722f762f737461626c652e706e67)](https://packagist.org/packages/vube/vagrant-boxer)[![Dependency Status](https://camo.githubusercontent.com/7849b8bd2c0509821cef2cb5dfe4f9d47fe469d97f55f4c2d60c521aa246f57c/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f757365722f70726f6a656374732f3533363133303162666530643037666136373030303062332f62616467652e706e67)](https://www.versioneye.com/user/projects/5361301bfe0d07fa670000b3)

Application to manage boxing up Vagrant VMs to be used as base boxes for use in private box distribution systems.

A complete example can be found here: [vagrant-boxer-example](https://github.com/xclusv/vagrant-boxer-example)

Features
--------

[](#features)

- Automatically package up Virtual Machines into reusable base boxes for use by other Vagrant configs.
- Automatically create/update [vagrant-catalog](https://github.com/vube/vagrant-catalog)metadata.json files so you can run your own private internal Vagrant Cloud.
- Automatically upload VM box images and metadata files to your file server.

Installation
------------

[](#installation)

To install, clone this repository and put it wherever you want it to live on your machine.

```
$ git clone https://github.com/vube/vagrant-boxer
$ cd vagrant-boxer
$ composer update
```

Then you can optionally symlink something like /usr/local/bin/boxer.php to this so it will run from your path just by typing `boxer.php`

```
$ sudo ln -sf /path/to/vagrant-boxer/boxer.php /usr/local/bin/boxer.php
```

Example Usage
-------------

[](#example-usage)

vagrant-boxer works either from command line switches or using a `boxer.json` config file. Here are examples of both.

### Usage via command line

[](#usage-via-command-line)

Note that the `{BASENAME}` below should be substituted with the name of the VM in your VirtualBox list.

```
$ boxer.php --verbose --base "{BASENAME}" --boxer-id "your-company/{BASENAME}"  --major-version 1.0 --url-prefix "http://your-file-server.com/" --upload-base-uri "username@your-file-server.com:/path/to/docroot"
```

Note: If you don't have `rsync` on your system, you can set the `--upload-method scp`flags on the command line to use `scp` instead. You can pass any command here that takes arguments in the form `command src1..srcN destination`

### Usage via boxer.json

[](#usage-via-boxerjson)

Here again, `{BASENAME}` should be substituted with the name of the VM in your VirtualBox list.

#### Running boxer.php using boxer.json

[](#running-boxerphp-using-boxerjson)

```
$ boxer.php --verbose --config-file /path/to/boxer.json
```

#### Contents of boxer.json

[](#contents-of-boxerjson)

```
{
    "vm-name": "{BASENAME}",
    "boxer-id": "your-company/{BASENAME}",
    "version": "1.0",
    "download-url-prefix": "http://your-file-server.com/",
    "upload-base-uri": "username@your-file-server.com:/path/to/docroot"
}
```

Dependencies
------------

[](#dependencies)

- PHP 5.3.2+
- Composer

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~31 days

Recently: every ~71 days

Total

11

Last Release

4085d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e93b948c39aebf57d2f7f3cf4d207e87568ebd9a98cd2dd13356c60a643bf10d?d=identicon)[ross-p](/maintainers/ross-p)

---

Top Contributors

[![sullb](https://avatars.githubusercontent.com/u/5346367?v=4)](https://github.com/sullb "sullb (2 commits)")

---

Tags

vagrantpackagervubevagrant box

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vube-vagrant-boxer/health.svg)

```
[![Health](https://phpackages.com/badges/vube-vagrant-boxer/health.svg)](https://phpackages.com/packages/vube-vagrant-boxer)
```

###  Alternatives

[deployer/deployer

Deployment Tool

11.0k25.4M207](/packages/deployer-deployer)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[wdalmut/php-deb-packager

A simple debian packager for PHP applications

5483.7k8](/packages/wdalmut-php-deb-packager)[wdalmut/php-deb-describe

A simple debian packager wrapper for PHP applications

1016.0k](/packages/wdalmut-php-deb-describe)[yousign/zdd-message-bundle

Assert Zero Downtime Deployment compliance for messages

28113.5k](/packages/yousign-zdd-message-bundle)[wapmorgan/php-rpm-packager

RPM packager for PHP applications.

106.3k](/packages/wapmorgan-php-rpm-packager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)