mark stale, solve #8484
[leap_vagrant.git] / README.md
1 About
2 =====
3
4 We're now using packer to build base boxes to get started, this repository is
5 only for historical reasons, check out
6 [packer_vagrant](https://leap.se/git/packer_vagrant.git) instead.
7
8 This repository contains Debian vagrant basebox definitions to get started with
9 [LEAP](https://leap.se).
10
11 That means a base Wheezy installation, with puppet, ruby, virtualbox guest
12 additions… Still kept as minimal as possible.
13
14 The installer used is the latest version of the installer and after the system
15 has been installed, the packages have been updated to the latest version at the
16 time the system was built.
17
18 Download pre-built baseboxes
19 ============================
20
21 Hashicorp's Atlas makes both hosting and versioining of baseboxes straightforward. You can find the ones we build from these definitions at [LEAP's account:](https://atlas.hashicorp.com/LEAP). Wheezy is what we focus on now, Jessie needs some work. You'll find there baseboxes for Virtualbox and KVM (libvirt). Signed checksums are at (https://downloads.leap.se/platform/).
22
23 Build basebox yourself
24 ======================
25
26 If you want to build a box yourself, you first need to install
27 [veewee](https://github.com/jedi4ever/veewee) and it's
28 dependencies.
29
30 Building should be straightforward using our pre-defined leap-wheezy
31 definitions:
32
33 Debian wheezy amd64
34 -------------------
35
36     veewee <provider> build  wheezy
37     veewee <provider> export wheezy
38
39 To use it in Vagrant, use
40
41     vagrant box add LEAP/wheezy /home/varac/dev/projects/leap/git/leap_vagrant/wheezy.box
42
43
44 Debian Jessie amd64
45 -------------------
46
47     veewee <provider> build  jessie
48     veewee <provider> export jessie
49
50 To use it in Vagrant, use
51
52     vagrant box add LEAP/jessie /home/varac/dev/projects/leap/git/leap_vagrant/jessie.box
53
54 Check out veewees documentation for all the options.
55
56 Issues
57 ======
58
59 * Libvirt images (KVM) are a lot larger as the Virtualbox ones (up to 1,5GB)
60   see https://github.com/jedi4ever/veewee/issues/929