doc/vagrant.md

69 lines
1.8 KiB
Markdown
Raw Normal View History

2014-07-01 18:29:08 +02:00
# Vagrant and YunoHost
*Here is a small memo-documentation page on how to test/develop YunoHost with Vagrant.*
*Find other ways to install YunoHost **[here](/install)**.*
<img src="https://yunohost.org/images/vagrant.png" width=250>
2014-07-02 20:36:03 +02:00
**Prerequisite**: an x86 computer with VirtualBox installed and enough RAM capacity to be able to run a small virtual machine.
2014-07-01 18:29:08 +02:00
---
2014-07-02 09:50:41 +02:00
## Initialization
2014-07-01 18:29:08 +02:00
Create a project folder
```bash
mkdir YunoHost
cd YunoHost
```
2015-09-29 12:15:17 +02:00
The following command will initialize the project with a Yunohost image based on Debian Jeesie
2014-07-01 18:29:08 +02:00
```bash
2015-09-29 12:15:17 +02:00
vagrant init yunohost/stable8
2014-07-01 18:29:08 +02:00
```
2014-12-04 12:40:12 +01:00
<blockquote>
2015-09-29 12:15:17 +02:00
<span class="text-warning">/!\</span> You must have a working image call `yunohost/stable8`. If not, just do
`vagrant box add yunohost/stable8 https://atlas.hashicorp.com/yunohost/boxes/stable8/versions/1.0.0/providers/virtualbox.box`
2014-12-04 12:40:12 +01:00
</blockquote>
2014-07-01 18:29:08 +02:00
---
2015-09-29 12:15:17 +02:00
## Run a vm
2014-07-01 18:29:08 +02:00
Start the virtual machine
```bash
vagrant up
```
2014-07-02 09:50:41 +02:00
Connect to the started virtual machine
2014-07-01 18:29:08 +02:00
```bash
vagrant ssh
```
Upgrade the system
```bash
sudo apt-get update && sudo apt-get upgrade
```
2015-09-29 12:15:17 +02:00
You can access to your vm with the ip 192.168.33.80
2014-07-01 18:29:08 +02:00
---
*Once the installation is finished, you may want to proceed to post-installation: **[yunohost.org/postinstall](/postinstall)** *
2015-09-29 12:15:17 +02:00
## Boxes with wheezy or testing/unstable repository
If you need a vm to test something with wheezy or testing/unstable version of Yunohost. There is a Vagrantfile and 5 other boxes in preparation. For the moment, you can build the boxes by following instructions on these repo: https://github.com/zamentur/yunohost-vagrant
| Box | IP |
| --- | --- |
| stable8 | 192.168.33.80 |
| testing8 | 192.168.33.81 |
| unstable8 | 192.168.33.82 |
| stable7 | 192.168.33.70 |
| testing7 | 192.168.33.71 |
| unstable7 | 192.168.33.72 |
2015-09-29 12:56:17 +02:00
The IP addresses related to the boxes are set by default but can be changed in the network settings.