Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dotzero/vagrant-debian-jessie

Automatic Debian 8 Vagrant base box building on OSX, Linux and Windows
https://github.com/dotzero/vagrant-debian-jessie

debian linux osx shell vagrant windows

Last synced: 23 days ago
JSON representation

Automatic Debian 8 Vagrant base box building on OSX, Linux and Windows

Awesome Lists containing this project

README

        

## About

This script will:

1. download and verify the latest `Debian "Jessie"` ISO
2. ... do some magic to turn it into a vagrant box file
3. output `debian-jessie-i386.box` or `debian-jessie-amd64.box`

## Requirements

* [Oracle VM VirtualBox](https://www.virtualbox.org/)
* [Vagrant](https://www.vagrantup.com/)
* `mkisofs` for generating a custom Debian CD image
* `7zip` for unpacking the Debian ISO image
* `md5sum` or `md5` for Debian ISO image hash check

## Usage on OSX

./build.sh

This should do everything you need. If you don't have `mkisofs` or `p7zip`, install [homebrew](http://brew.sh/), then:

brew install cdrtools
brew install p7zip

To add `debian-jessie-amd64.box` with name `debian-jessie` into vagrant:

vagrant box add "debian-jessie" debian-jessie-amd64.box

## Usage on Linux

./build.sh

This should do everything you need. If you don't have `mkisofs` or `p7zip`:

sudo apt-get install genisoimage
sudo apt-get install p7zip-full

To add `debian-jessie-amd64.box` with name `debian-jessie` into vagrant:

vagrant box add "debian-jessie" debian-jessie-amd64.box

## Usage on Windows (under cygwin/git shell)

./build.sh

Tested under Windows 7 with this tools:

* [cpio](http://gnuwin32.sourceforge.net/packages/cpio.htm)
* [md5](http://www.fourmilab.ch/md5/)
* [7zip](http://www.7-zip.org/)
* [mkisofs](http://sourceforge.net/projects/cdrtoolswin/)

To add `debian-jessie-amd64.box` with name `debian-jessie` into vagrant:

vagrant box add "debian-jessie" debian-jessie.box

## Environment variables

You can affect the default behaviour of the script using environment variables:

VAR=value ./build.sh

The following variables are supported:

* `ARCH` - Architecture to build. Either `i386` or `amd64`. Default is `amd64`;

* `DEBIAN_CDIMAGE` - Domain to download the Debian installer from. Default is `cdimage.debian.org`. Example: `ftp.de.debian.org`;

* `PRESEED` — Path to custom preseed file. May be useful when if you need some customizations for your private base box (user name, passwords etc.);

* `LATE_CMD` — Path to custom late_command.sh. May be useful when if you need some customizations for your private base box (user name, passwords etc.);

* `VM_GUI` — If set to `yes` or `1`, disables headless mode for vm. May be useful for debugging installer;

## License

Licensed under the MIT license: http://www.opensource.org/licenses/mit-license.php