Installing AjaXplorer in 4 steps (zip archive)

This quick-install guide will cover most common cases : you have an FTP access to a remote server running PHP (>5.1) and accessible through the web. If you can log directly on the server via SSH, you will probably know how to skip some of these steps. There is this tutorial for CentOS users written by Mathieu on Argeo’s wiki, as well as specific upgrade instructions if you are coming from an existing installation. Others, well, follow the steps!

1 Download the latest build of AjaXplorer from the download page, and extract its content (using any zip tool like winzip, 7zip, tar -xzf on linux…) somewhere on your computer.

2 Upload the archive content on the server (via FTP) in a web-accessible folder. Make sure that the « data » sub-folder is writeable by the webserver.
For example put it in /your/web/root/ajaxplorer.

3 Access the installation via the web browser : the AjaXplorer Diagnostic Tool is launched and tries to detect problems.
Review any error or warnings then click on « Continue to AjaXplorer ».
The URL may look like www.domain.tld/ajaxplorer/

4 Log in with the admin/admin credentials and change the admin password now. AjaXplorer is up and running!
The « Change Password » menu is accessible by clicking on the « Logged as admin » button.

Installing AjaXplorer using the Linux packages

RPM packages of AjaXplorer are available. They have been built and tested on Enterprise Linux 6 (RHEL / CentOS / Scientific Linux). They should be straightforward to install or repackage on other RPM-based distributions. For some reason the signature is not recognized on Fedora, should be fixed soon. Debian packages are available and they run smoothly on both Debian and Ubuntu (see below). Thanks to Argeo for the first pass on RPMs, and to Aurélien Requiem for the Debian packaging.

Enterprise Linux RPM Installation

sudo rpm -Uvh http://dl.ajaxplorer.info/repos/el6/ajaxplorer-stable/ajaxplorer-release-4-1.noarch.rpm

Or simply click on this link and install via GUI tools. This will install /etc/yum.repos.d/ajaxplorer.repo which configures the repository, allowing update management. Once installed, update the yum database and install ajaxplorer :

sudo yum update
sudo yum install ajaxplorer

Restart Apache, then open http://localhost/ajaxplorer.

Debian/Ubuntu users

You’ll have to manually append the following lines in your /etc/apt/sources.list file :

deb http://dl.ajaxplorer.info/repos/apt stable main
deb-src http://dl.ajaxplorer.info/repos/apt stable main

Then you have to install the public key using the following command :

wget -O - http://dl.ajaxplorer.info/repos/charles@ajaxplorer.info.gpg.key | sudo apt-key add -

Finally, update the apt-get database and install ajaxplorer :

sudo apt-get update
sudo apt-get install ajaxplorer

Copy the apache config sample :

cp /usr/share/doc/ajaxplorer/apache2.sample.conf /etc/apache2/sites-enabled/ajaxplorer.conf

Restart Apache, then open http://localhost/ajaxplorer.

NOTE : If you want to install the "dev" release, you can use the deb "testing" distribution instead of "stable", which would change the sources.list entry to

deb http://dl.ajaxplorer.info/repos/apt testing main
deb-src http://dl.ajaxplorer.info/repos/apt testing main

What's next?

You will probably want to create repositories and users right away, but we recommend you the following readings before :

But if you are confident enough, you can jump directly to the Users, Roles & Repositories section.