eyeOS and XAMPP

A quick guide to getting eyeOS running on a XAMPP server

The following is a brief guide for anyone having difficulties installing eyeOS. To get eyeOS running 
on a server you'll need the following:
­ A server, ideally Apache.
­ PHP5
­ The eyeOS download
­ A little bit of UNIX sysadmin experience if you're using Linux

In most cases it's just a matter of copying the extracted eyeOS download to a folder and starting 
the program in a web browser. If your system isn't configured to run as a server, or you have 
problems getting it to run properly, fear not. There's a handy download available called XAMPP 
which, in addition to the basic server program, has all the PHP and SQL/MySQL modules you'll 
need, plus a nice web­based admin interface.

1. Download XAMPP 
The conventional way of going about this is to install Apache and add the PHP modules separately.
Instead, I recommend using XAMPP, which I found is much easier to set up, and already includes 
everything needed. It's available for Windows, Mac and Linux from 
www.apachefriends.org/en/xampp.html

2. Installing XAMPP
The next step is to install the XAMPP server. Assuming it's on a Linux system, the installation's 
done the old­fashioned way by opening a terminal session as the root user and moving to the 
directory where you downloaded the XAMPP file to.
We want to install XAMPP to the /opt directory, so we use the following command:

user@linux: su
password:
root@linux: tar xvfz xampp-linux-1.7.3.tar.gz -C /opt

After the usual dependency check and compiling is finished, the XAMPP directory will be created in 
/opt

3. Start the XAMPP server
Assuming there weren't any problems installing XAMPP, all we need to do is start the server with 
the following command:

root@linux: /opt/lampp/lampp start

A message will confirm the server's running. 
4. Test the server
Open a web browser, and enter http://localhost/ in the address bar. If everything's running as it 
should, the XAMPP home page will be displayed. Congratulations ­ you now have a running web 
server. 

5. Download eyeOS
Now that we have a working web server, it's a simple matter of setting up eyeOS. Get the download 
from http://eyeos.org and extract it so you have a directory called eyeOS in the downloads folder.

Copy the directory to /opt/lammp/htdocs/xampp/eyeOS. Next, change the permissions for the 
eyeOS folder and all its subdirectories to allow everyone to view, modify and execute.
You might want to change the directory's name from 'eyeOS' to 'eyeosx', as it will be more 
convenient for the name to be in lower case.

6. Set up and test eyeOS
Open a web browser and enter http://localhost/xampp/eyeosx/index.php in the address bar. Now 
eyeOS should start up and run perfectly, and you'll be presented with the login screen followed by 
the eyeOS desktop.
7. Secure the server
If you intend to use your system as an online web server, it's very important to secure XAMPP first. 
The /opt/lampp/lampp security command will solve most the security issues, but further 
configuration is recommended, most of which can be done in the server admin page.

External Links
eyeOS Project http://eyeos.org
eyeOS Public Server http://eyeos.info
XAMPP Server Page www.apachefriends.org/en/xampp.html

Michael Johnson
michael.555@programmer.net
http://sourceforge.net/projects/michael555