Installing And Working With eyeOS Under Debian 4.0

This tutorial shows how you can install eyeOS on a standard Linux system. When you have finished this tutorial, you will have a full, working eyeOS on your server. eyeOS is a kind of operating system which works online, i.e. it manages files on the server and enables the user to upload, download and edit files. We use a Debian 4.0 system for this demonstration purpose. The first thing we need to do, is to install an Apache webserver and PHP. If you have this installed already, you can go straight to step 2.


Step 1: Installing Apache and PHP

To install Apache and PHP simply execute this on the shell:

apt-get install apache2 libapache2-mod-php5

and the program will do everything.


Step 2: Download eyeOS

You need to change the path to the www folder as follows:

cd /var/www

Now you can download the file, either via the link given here or by picking another from there:

To start the download simply enter the following into your shell:


Now you should find a file called eyeOS_1.0.1.tar.gz on your harddrive.


Step 3: Preparing for installation

Before we can start the setup, we need to unpack the archive we downloaded in step 2. This is done by using tar on the shell:

tar xvfz eyeOS_1.0.1.tar.gz

For the installation, you need to change the rights of the folder to 777:

chmod 777 eyeOS

This is only needed for the setup and can be undone later.


Step 4: Installing eyeOS

The actual installation process is accounted for by a php script. We need to execute this in our webbrowser. To do this we navigate to the server or localhost, if you are sitting on the machine. You should see a placeholder page created by the Apache webserver to notify you that the installation worked. Now go into the subfolder eyeOS by appending it to the path in the address bar, and navigate to the file install.php, e.g. http://yourserver/eyeOS/install.php.

You shold now see the welcome screen of eyeOS similar to the one below, where you can enter the root password as shown:

When you klick on Install eyeOS 1.0 eyeOS will be installed and you are redirected to the logon screen.


Step 5: Working with eyeOS

When navigating to the URL of the eyeOS folder, you should see the logon screen (at least the first time) you can now enter the credentials you specified earlier on, and click Enter:

Then you will see the "desktop" of your eyeOS:

The green bar on the bottom provides you with the ability to execute system actions like changing preferences or ending the session (= logoff)
Some basic programs are already installed, in particular these are text editors, a calendar software, a calculator, a chess game and even a browser!

The file manager and the text editing software are shown below:

Regarding text editing, you are provided with "eyeDocs" which can edit and save text in a format using the HTML-font tags, and the more simplistic version, eyeNotes which can only edit plain text.

By using the green bar on the bottom of the screen, you can get an overview over the installed programs:

And play a game of chess if you like ...

The integrated browser is called eyeNav and does work with most sites - because it is the very browser you are using to view eyeOS. However, it is possible that the site used javascript and is incompatible with eyeNav.

You even have a process manager in which you can kill processes you have started:

Hopefully, you can now install and operate an eyeOS system under Debian.



Share this page:

2 Comment(s)

Add comment


From: at: 2007-06-11 18:49:35

Great HOWTO! Thanks.

 There is already eyeOS 1.0.3. With the new version the HOWTO works exactly the same way, except for the link to the download package.  

From: Anonymous at: 2009-08-29 13:52:28

Can't wait till version 2.0 of eyeOS! from the hype I've seen it's going to have many improvements.