• A web server - preferably Apache
  • PHP 4.3 or above with xml support
  • SQL server - preferably MySQL 4.1 or above
  • GD or ImageMagick for the photo organizer

Getting the most recent version

Download the tarball (stable release) from here, for those that like the newest of new you can checkout the latest SVN release. To obtain the SVN release:

svn co svn://

Installation process

If you go with the stable tarball option, you will need to extract the tarball:

~>tar -zxvf jaws-project-0.5.5.tar.gz

Change to the newly created Jaws directory:

~> cd jaws-project-0.5.5

Copy the contents of the “html” directory to the web server documentation root directory that you wish to use - for example /srv/www/htdocs (you may need root privileges):

~/jaws-project-0.5.5> cp -r html/* /srv/www/htdocs

Change to the directory that you copied the files to:

~> cd /srv/www/htdocs

Ensure that the “data” and “include” directories are writeable by your webserver:

/srv/www/htdocs> chown -R wwwrun data/ include/

Check what the webserver user is called, on SUSE it is wwwrun and Ubuntu it is www-data

Open install.php in your web browser :

You will be greeted with the following screen:

Follow the instructions on the screen and then click “next”

The next screen asks you to authenticate your installation. This is done by simply creating a text file with the randomly created authentication key that is presented to you like this one:

Once you have done the “key.txt” file as asked and selected next, you are then asked to enter your DataBase details:

The options are pretty self explanatory -
Hostname: The hostname of the SQL server that you wish to use.
Username: The database username that you wish to use.
Password: The database user’s password.
Database Name: The name of the database that you wish to use.
Table Prefix: An identifier so that you can have several sites using the same database.

Once you have entered the database details, you are then presented with the initial user details that you would like to use (more users may be added after installation is complete - if you want):

Again, the questions asked are self explanatory -
Username: This is the login name that you wish to use, it is also the name that is displayed on posts etc.
Password: The password you wish to use for your newly created user.
Repeat: Re-enter the password you chose.
Name: The real name of the user, this is handy if you have a multi-user site and can’t remember who is who.
E-Mail Address: A valid e-mail address is required.

Once you create your user, you are then presented with the Site Settings page:

The options presented here are -
Site Name: This is what you would like your site to be calle. e.g: The Jaws Project.
Description: A description of your site, this doesn’t neccisarly mean an exact description although it helps. e.g: The ultimate CMS product, or We chew minnows for fun.
Address: This is where you enter the URL address that people would enter into their browser to access your site.
Default Gadget: Here is where you select what gadget you would like to use as the main option for you site.
Language: Choose your site’s language.

After you select your site options, you are then asked to save your new configuration:

Providing your “include” directory is writtable then all you have to do is click next, if it is not follow the instructions on screen.

Once the settings have been saved, you are then presented with the finish page which allows you to access your new website:

Here you are given the choice of either accessing your website or the admin section of your site -
View your site: To view your site browse to
Login to the control panel: To access the control panel to add content etc browse to

Guia de Instalación

Traducción al español por JAHS

Requerimientos previos.

  • Un servidor de paginas web.
  • PHP version 4.3 o 5.0 con soporte para xml.
  • GD o ImageMagick para el organizador de fotografias.

Obteniendo la versión mas reciente.

Ud. puede descargar la ultima versión del repositorio “Subversion”. Si Ud. desea descargarla del repositorio utilize este comando (Por supuesto Ud. necesita haber instalado svn previamente).

svn co svn://

Proceso de instalación.

  • Desempaquete el “tarball” (Nota del traductor: esto se puede realizar en Linux / Unix usando el comando tar -xzf archivo.tgz, o en otros sistemas operativos con alguna utileria de descompresion a.k.a ZIP).
  • Copie el directorio “html” al directorio de contenido donde corre su servidor web, por ejemplo “public_html”.
  • Configure los directorios “html/data/” y “html/include/” para que puedan ser modificados por su servidor web (Nota del traductor: Esto es, que el servidor web pueda escribir en ellos), por ejemplo:
          chgrp R wwwdata data/include/
          chmod R 775 data/include/

(Nota del traductor: Los anteriores sentencias aplican a sistemas Linux / Unix, en caso de que este utilizando otro sistema operativo, verifique el esquema de permisos y usuarios en la documentacion de sus sistema para ver las sentencias a utilizar).

  • Siga las instrucciones en pantalla.

Probablemente Ud. desee desabilitar el acceso a escritura de “include” una vez que haya terminado de instalar. Puede utilizar la siguiente sentencia (Nota del traductor: La siguiente sentencia aplica a sistemas Linux / Unix, en caso de que este utilizando otro sistema operativo, verifique el esquema de permisos y usuarios en la documentacion de sus sistema para ver las sentencias a utilizar):

chmod R 755 include/
  /var/www/wiki/htdocs/data/jaws/v05/installation.txt · Last modified: 2007/11/02 16:27