{"id":139323,"date":"2014-06-16T21:57:03","date_gmt":"2014-06-16T20:57:03","guid":{"rendered":"https:\/\/2014.manchester.wordcamp.org\/?page_id=139323"},"modified":"2014-06-16T21:57:03","modified_gmt":"2014-06-16T20:57:03","slug":"setting-up-your-machine-for-contributor-day","status":"publish","type":"page","link":"https:\/\/manchester.wordcamp.org\/2014\/setting-up-your-machine-for-contributor-day\/","title":{"rendered":"Setting Up Your Machine for Contributor Day"},"content":{"rendered":"<h2 style=\"color: #333333\">Getting Started<\/h2>\n<p>The basic requirement is to have a local web server on your machine that you can run WordPress on. There are a number of different ways to do that; <a href=\"http:\/\/www.mamp.info\/\">MAMP<\/a>, <a href=\"http:\/\/www.wampserver.com\/\">WAMP<\/a>, <a href=\"https:\/\/www.apachefriends.org\/index.html\">XAMPP<\/a>, etc. The problem with those solutions is that they can be difficult to set up, especially if you want to run more than one copy of WordPress. Another way to run a local web server is to install a virtual machine that runs independently of your desktop or Laptop OS. Again, there are a number of solutions, both free and paid. The solution we recommend is VirtualBox and Vagrant. This combination allows you to create virtual environment much closer to a real web server, and have it automatically set up everything, including WordPress, correctly for you. The full solution we recommend is one called <a href=\"https:\/\/github.com\/Varying-Vagrant-Vagrants\/VVV\">Varying Vagrant Vagrants<\/a> (VVV), originally developed by <a href=\"http:\/\/10up.com\/\">10up<\/a>\u00a0and transitioned to a community organisation in 2014.<\/p>\n<p>The following instructions, taken from the <a href=\"https:\/\/github.com\/Varying-Vagrant-Vagrants\/VVV\">VVV Github page<\/a>, apply to Windows, Mac, and Linux environments.<\/p>\n<h3 style=\"color: #333333\"><a class=\"anchor\" style=\"color: #4183c4\" href=\"https:\/\/github.com\/Varying-Vagrant-Vagrants\/VVV#what-is-vagrant\" name=\"user-content-what-is-vagrant\"><\/a>What is Vagrant?<\/h3>\n<p style=\"color: #333333\"><a style=\"color: #4183c4\" href=\"http:\/\/www.vagrantup.com\/\">Vagrant<\/a>\u00a0is a &#8220;tool for building and distributing development environments&#8221;. It works with\u00a0<a style=\"color: #4183c4\" href=\"http:\/\/en.wikipedia.org\/wiki\/X86_virtualization\">virtualization<\/a>\u00a0software such as\u00a0<a style=\"color: #4183c4\" href=\"https:\/\/www.virtualbox.org\/\">VirtualBox<\/a>\u00a0to provide a virtual machine that is sandboxed away from your local environment.<\/p>\n<h3 style=\"color: #333333\"><a class=\"anchor\" style=\"color: #4183c4\" href=\"https:\/\/github.com\/Varying-Vagrant-Vagrants\/VVV#the-first-vagrant-up\" name=\"user-content-the-first-vagrant-up\"><\/a>The First Vagrant Up<\/h3>\n<ol class=\"task-list\" style=\"color: #333333\">\n<li>Start with any operating system.<\/li>\n<li>Install\u00a0<a style=\"color: #4183c4\" href=\"https:\/\/www.virtualbox.org\/wiki\/Downloads\">VirtualBox 4.3.10<\/a>\n<ul class=\"task-list\">\n<li>VVV is completely compatible with earlier versions of VirtualBox, so 4.2.22 or earlier would be just fine. Do note that Vagrant had specific issues with 4.2.16. Going as far back as 4.2.10 will likely be of no issue.<\/li>\n<li>VVV itself leans in the 4.3.x direction in the master branch to stay ahead of the curve.<\/li>\n<\/ul>\n<\/li>\n<li>Install\u00a0<a style=\"color: #4183c4\" href=\"http:\/\/www.vagrantup.com\/downloads.html\">Vagrant 1.5.4<\/a>\n<ul class=\"task-list\">\n<li><code>vagrant<\/code>\u00a0will now be available as a command in your terminal, try it out.<\/li>\n<li><strong><em>Note:<\/em><\/strong>\u00a0If Vagrant is already installed, use\u00a0<code>vagrant -v<\/code>\u00a0to check the version. You may want to consider upgrading if a much older version is in use.<\/li>\n<li><strong><em>Note:<\/em><\/strong>\u00a0If VirtualBox 4.3.x is installed, Vagrant 1.3.5 or later is required.<\/li>\n<\/ul>\n<\/li>\n<li>Install the\u00a0<a style=\"color: #4183c4\" href=\"https:\/\/github.com\/cogitatio\/vagrant-hostsupdater\">vagrant-hostsupdater<\/a>\u00a0plugin with\u00a0<code>vagrant plugin install vagrant-hostsupdater<\/code>\n<ul class=\"task-list\">\n<li>Note: This step is not a requirement, though it does make the process of starting up a virtual machine nicer by automating the entries needed in your local machine&#8217;s\u00a0<code>hosts<\/code>\u00a0file to access the provisioned VVV domains in your browser.<\/li>\n<li>If you choose not to install this plugin, a manual entry should be added to your local\u00a0<code>hosts<\/code>\u00a0file that looks like this:\u00a0<code>192.168.50.4 vvv.dev local.wordpress.dev local.wordpress-trunk.dev src.wordpress-develop.dev build.wordpress-develop.dev<\/code><\/li>\n<li>Note that you may need to make the hosts file writable by the user you run Vagrant as for the hosts updater to work without requiring a password.<\/li>\n<\/ul>\n<\/li>\n<li>Install the\u00a0<a style=\"color: #4183c4\" href=\"https:\/\/github.com\/emyl\/vagrant-triggers\">vagrant-triggers<\/a>\u00a0plugin with\u00a0<code>vagrant plugin install vagrant-triggers<\/code>\n<ul class=\"task-list\">\n<li>Note: This step is not a requirement. It does allow for various scripts to fire when issuing commands such as\u00a0<code>vagrant halt<\/code>\u00a0and\u00a0<code>vagrant destroy<\/code>.<\/li>\n<li>By default, if vagrant-triggers is installed, a\u00a0<code>db_backup<\/code>\u00a0script will run on halt, suspend, and destroy that backs up each database to a\u00a0<code>dbname.sql<\/code>\u00a0file in the\u00a0<code>{vvv}\/database\/backups\/<\/code>\u00a0directory. These will then be imported automatically if starting from scratch. Custom scripts can be added to override this default behavior.<\/li>\n<\/ul>\n<\/li>\n<li>Clone or extract the Varying Vagrant Vagrants project into a local directory\n<ul class=\"task-list\">\n<li><code>git clone git:\/\/github.com\/Varying-Vagrant-Vagrants\/VVV.git vagrant-local<\/code><\/li>\n<li>OR download and extract the repository master\u00a0<a style=\"color: #4183c4\" href=\"https:\/\/github.com\/varying-vagrant-vagrants\/vvv\/archive\/master.zip\">zip file<\/a><\/li>\n<li>OR grab a\u00a0<a style=\"color: #4183c4\" href=\"https:\/\/github.com\/varying-vagrant-vagrants\/vvv\/releases\">stable release<\/a>\u00a0if you&#8217;d like some extra comfort.<\/li>\n<\/ul>\n<\/li>\n<li>Change into the new directory with\u00a0<code>cd vagrant-local<\/code><\/li>\n<li>Start the Vagrant environment with\u00a0<code>vagrant up<\/code>\n<ul class=\"task-list\">\n<li>Be patient as the magic happens. This could take a while on the first run as your local machine downloads the required files.<\/li>\n<li>Watch as the script ends, as an administrator or\u00a0<code>su<\/code>\u00a0<strong><em>password may be required<\/em><\/strong>\u00a0to properly modify the hosts file on your local machine.<\/li>\n<\/ul>\n<\/li>\n<li>Visit any of the following default sites in your browser:\n<ul class=\"task-list\">\n<li><a style=\"color: #4183c4\" href=\"http:\/\/local.wordpress.dev\/\">http:\/\/local.wordpress.dev\/<\/a>\u00a0for WordPress stable<\/li>\n<li><a style=\"color: #4183c4\" href=\"http:\/\/local.wordpress-trunk.dev\/\">http:\/\/local.wordpress-trunk.dev\/<\/a>\u00a0for WordPress trunk<\/li>\n<li><a style=\"color: #4183c4\" href=\"http:\/\/src.wordpress-develop.dev\/\">http:\/\/src.wordpress-develop.dev\/<\/a>\u00a0for trunk WordPress development files<\/li>\n<li><a style=\"color: #4183c4\" href=\"http:\/\/build.wordpress-develop.dev\/\">http:\/\/build.wordpress-develop.dev\/<\/a>\u00a0for the version of those development files built with Grunt<\/li>\n<li><a style=\"color: #4183c4\" href=\"http:\/\/vvv.dev\/\">http:\/\/vvv.dev\/<\/a>\u00a0for a default dashboard containing several useful tools<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p style=\"color: #333333\">Fancy, yeah?<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Getting Started The basic requirement is to have a local web server on your machine that you can run WordPress on. There are a number of different ways to do that; MAMP, WAMP, XAMPP, etc. The problem with those solutions is that they can be difficult to set up, especially if you want to run &hellip; <a href=\"https:\/\/manchester.wordcamp.org\/2014\/setting-up-your-machine-for-contributor-day\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Setting Up Your Machine for Contributor Day<\/span> <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":6699784,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"open","template":"","meta":{"_crdt_document":"","jetpack_post_was_ever_published":false,"footnotes":""},"class_list":["post-139323","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/pages\/139323","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/users\/6699784"}],"replies":[{"embeddable":true,"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/comments?post=139323"}],"version-history":[{"count":6,"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/pages\/139323\/revisions"}],"predecessor-version":[{"id":139333,"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/pages\/139323\/revisions\/139333"}],"wp:attachment":[{"href":"https:\/\/manchester.wordcamp.org\/2014\/wp-json\/wp\/v2\/media?parent=139323"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}