2015-01-14 12:32:10 -05:00
|
|
|
Vagrant for Friendica Developers
|
|
|
|
|
===================
|
|
|
|
|
|
|
|
|
|
* [Home](help)
|
|
|
|
|
|
2015-04-17 10:58:48 -04:00
|
|
|
Getting started
|
|
|
|
|
---------------
|
2015-02-02 17:14:01 -05:00
|
|
|
|
2015-04-17 03:13:40 -04:00
|
|
|
[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:
|
2015-01-14 12:32:10 -05:00
|
|
|
|
|
|
|
|
1. Install VirtualBox and vagrant.
|
2015-04-17 03:13:40 -04:00
|
|
|
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.
|
2015-01-14 12:32:10 -05:00
|
|
|
4. Run "vagrant ssh" to log into the virtual machine to log in to the VM.
|
2015-04-17 03:13:40 -04:00
|
|
|
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".
|
2015-01-14 12:32:10 -05:00
|
|
|
6. Work on Friendica's code in your git clone on your machine (not in the VM).
|
2015-04-17 03:13:40 -04:00
|
|
|
7. Check the changes in your browser in the VM.
|
|
|
|
|
Debug via the "vagrant ssh" login.
|
2015-01-14 12:32:10 -05:00
|
|
|
8. Commit and push your changes directly back to Github.
|
2015-01-16 05:20:48 -05:00
|
|
|
|
|
|
|
|
If you want to stop vagrant after finishing your work, run the following command
|
|
|
|
|
|
|
|
|
|
$> vagrant halt
|
|
|
|
|
|
|
|
|
|
in the development directory.
|
|
|
|
|
|
2015-04-17 10:58:48 -04:00
|
|
|
Import test data
|
|
|
|
|
----------------
|
2015-02-02 17:14:01 -05:00
|
|
|
|
|
|
|
|
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
|
2015-04-17 03:08:57 -04:00
|
|
|
* friendica1, password friendica1
|
2015-02-02 17:14:01 -05:00
|
|
|
* 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.
|
|
|
|
|
|
2015-01-16 05:20:48 -05:00
|
|
|
For further documentation of vagrant, please see [the vagrant*docs*](https://docs.vagrantup.com/v2/).
|
