X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=doc%2FVagrant.md;h=979c5c49b6ae50b081cf32ccff48dc44abb13900;hb=c8fdff32b311ef9e547e8d29f06725c8378c8c6e;hp=fd6b818e7841c5c70cbb51b2b034ccd2be9977e3;hpb=36724eb8ea53cc2272b6c86b153e16f9a09062dd;p=friendica.git diff --git a/doc/Vagrant.md b/doc/Vagrant.md index fd6b818e78..979c5c49b6 100644 --- a/doc/Vagrant.md +++ b/doc/Vagrant.md @@ -3,15 +3,25 @@ Vagrant for Friendica Developers * [Home](help) -[Vagrant](https://www.vagrantup.com/) is a virtualization solution for developers. No need to setup up a webserver, database etc. before actually starting. Vagrant creates a virtual machine (an Ubuntu 12.04) for you that you can just run inside VirtualBox and start to work directly on Friendica. What you need to do: +Getting started +--------------- + +[Vagrant](https://www.vagrantup.com/) is a virtualization solution for developers. +No need to setup up a webserver, database etc. before actually starting. +Vagrant creates a virtual machine (an Ubuntu 12.04) for you that you can just run inside VirtualBox and start to work directly on Friendica. +What you need to do: 1. Install VirtualBox and vagrant. -2. Git clone your Friendica repository. Inside, you'll find a "Vagrantfile" and some scripts in the utils folder. -3. Run "vagrant up" from inside the friendica clone. Be patient: When it runs for the first time, it downloads an Ubuntu Server image. +2. Git clone your Friendica repository. +Inside, you'll find a "Vagrantfile" and some scripts in the utils folder. +3. Run "vagrant up" from inside the friendica clone. +Be patient: When it runs for the first time, it downloads an Ubuntu Server image. 4. Run "vagrant ssh" to log into the virtual machine to log in to the VM. -5. Open 192.168.22.10 in a browser to finish the Friendica installation. The mysql database is called "friendica", the mysql user and password both are "root". +5. Open 192.168.22.10 in a browser to finish the Friendica installation. +The mysql database is called "friendica", the mysql user and password both are "root". 6. Work on Friendica's code in your git clone on your machine (not in the VM). -7. Check the changes in your browser in the VM. Debug via the "vagrant ssh" login. +7. Check the changes in your browser in the VM. +Debug via the "vagrant ssh" login. 8. Commit and push your changes directly back to Github. If you want to stop vagrant after finishing your work, run the following command @@ -20,4 +30,19 @@ If you want to stop vagrant after finishing your work, run the following command in the development directory. +Import test data +---------------- + +If you want some test data in your vagrant Friendica instance import the database dump friendica_test_data.sql like so (inside the VM): + + $> mysql -u root -p friendica < /vagrant/friendica_test_data.sql + +You will then have the following accounts to login: + + * admin, password admin + * friendica1, password friendica1 + * friendica2, password friendica2 and so on until friendica5 + * friendica1 is connected to all others. friendica1 has two groups: group1 with friendica2 and friendica4, group2 with friendica3 and friendica5. + * friendica2 and friendica3 are conntected. friendica4 and friendica5 are connected. + For further documentation of vagrant, please see [the vagrant*docs*](https://docs.vagrantup.com/v2/).