Recent versions: ||| Galaxytool: v5.1 ||| Galaxytoolbar: v2.6.32 |||

Local GalaxyTool under Mac OS

From Galaxytool wiki
Jump to: navigation, search

Ex ante

Why is this a Mac OS guide only?

Simple answer: I'm a Mac user and don't know how to setup a web server on a PC ;)

What is a local web server?

A web server is a computer which transmits documents to web browsers. Web servers are mainly used as WWW-service in the internet, but also in corporate networks and locally. This way, documents can be made available world wide, company-internal or locally.

Who will have access to the local Galaxytool?

This guide will tell you how to setup a Galaxytool on a local web server. Thus only yourself and people in the same local network can access it. In principle, you can make your Galaxytool available to all your Allymates. But the software which is used in this guide is designed for local use only and unsafe if it's used in another way.

The software

Under Mac OS there is a pre-installed apache web server. But we need PHP and MySQL modules in order to make the Galaxytool work on the web server.

XAMPP for Mac OS X

After downloading simply run the following commands in the terminal (Programs/Utility Programs):

     Installation requires an admin account.
     # Enter „sudo su“. You will be prompted for a password.
     # tar xfvz xampp-macosx-0.7.2.tar.gz -C /
     Notice: all old installations of XAMPP for MacOS X will be overwritten! 

That's all. XAMPP is now installed below the /Applications/xampp directory.

Activating web-sharing

You activate web-sharing under Programs/Configuration/Sharing

Simply check the box next to "Web-Sharing"

Setting up the Galaxytool

First of all, download the latest Galaxytool software Version: 4.3.2 tar.gz and extract the files to your desktop.

The following steps are taken from the GalaxyTool Guide, but attention, there are some major changes.

Open TextEdit for this.

Once TextEdit is open, you will need to open the config folder. I will assume that you saved the extracted file to the desktop. Open the Galaxy tool folder. Open config

We will only be changing four things

     $dbusername = "databasename"; // database username
     $dbpassword = "userpassword"; // database password
     $dbname = "databasename"; // database name
     $dbhost = "mysql"; // host address of your mysql server

--> insert:

     $dbusername = "root";
     $dbpassword = "";
     $dbname = "galatool";
     $dbhost = "localhost";

Once you have made the changes save the file (Not save as).

Now from TextEdit open attributes. Here is what you will need to change

     $owner = "youralliancenamehere";
     The quotes must remain
     $email_to = 'youremailhere'
     Quotes must stay
     $default_language = "languageyouwanthere";
     Quotes must remain
     $global_universe = 00;
     Put your universe number there. Keep the ;

Now save this (not save as). Close TextEdit.

Assembling the Galaxytool and the web server

Open your browser and visit


Here go to phpMyAdmin and create a new database "galatool" (collation latin1)

Now take your Galaxytool folder and move it to

/Your User name/Websites

Installing the Galaxytool

Open your browser and visit


click "install"

It's ready!

Now your offline Galaxytool should be ready, the URL of the login screen is


     Username: admin
     Pw: galatool

You will have to start the database every time your systems is rebooted. You start the database with the "XAMPP Control Panel" (see xampp folder), simply start all components.

Settings for the Galaxytoolbar

     Galaxytool URL: http://localhost/~Username/galaxytool/secret/galaxyplugin.php
     Username: admin
     Password: galatool

--LUDa 11:54, 25 March 2008 (CET)