====== This is now outdated. Use Docker instead. (May 2017) ======

[[Docker|docker setup guide]]


=== phpList virtual machine ===

In order to work on phpList, you may try to set up the virtual machine with phpList.

You will need [[http://www.virtualbox.org|VirtualBox]] for this.

Once you have VirtualBox installed, you can download the [[https://s3.amazonaws.com/phplist/phpList20140730.ova|phpList virtual machine]].

When you set up the virtual machine, you need to make sure it gets an IP address in your local network. To do that, set the network adapter to be a Bridged Adapter.

{{:develop:vbox-network.png?200|}}


Fire up the machine, and wait until you get the login prompt 

<code>
phplist login:
</code>


Type username phplist, password phplist

Once you're in, run the command

<code>
/sbin/ifconfig
</code>

to find the IP address of your server, on the line where it says //inet addr//

In my case the address is **192.168.1.85**

Now go to your browser and load

<code>
http://192.168.1.85/lists/admin/
</code>

I have put the IP address in my hosts file, and pointed "test.phplist.com" to it. As a result, I load http://test.phplist.com/lists/admin in my browser. 

Login is "admin/phplist".

You can now also **ssh** to the machine, using
<code>
ssh 192.168.1.85 -l phplist
type password phplist
</code>

The machine is set to update the code every hour. To change the location of the code, and point to your own clone, you need to do the following, once logged in to the machine

<code>
cd phplist
git remote remove origin; 
git add remote origin https://github.com/yourgithubname/phplist.git
</code>

After that, it will run on your own clone of the phpList code.


MORE TO FOLLOW