Wednesday, 10 March 2010
Home | Gunther | mamgoo | Search & Rescue
Installing Gunther

Requirements


At the moment Gunther requires PHP 4.3 or greater. It also requires that PHP not be in safe-mode and probably not a CGI. I don't think Gunther runs well under Windows at the moment. I think current problems under Windows are probably easy to fix but I don't have access to Windows to do this myself.

Installation - Quick Explanation


Unzip Gunther into your web space (if uploading, read item 2 below for relevant file permission changes), go to gunther/admin/login.php in your web-browser, create an admin account, login, create you first page (call it index).

Installation - Longer Explanation


1. Download latest Gunther distribution from http://gunther.sourceforge.net

2. Upload Gunther to your web-space. It is recommended that you decompress the Gunther distribution archive 'in-situ' as this will preserve the necessary directory permissions and ensure that your Gunther installation contains certain 'invisible' files (.htaccess files) which improve security. If you can't do this, don't worry - upload all the files contained within the Gunther archive then ensure that these directories are readable and writable by everyone (chmod 777):

   gunther/data
   gunther/private
   gunther/uploads

Note for Konqueror users: Some users of Konqueror have reported that relying on Konqueror to unzip the Gunther archive sometimes results in a missing 'uploads' directory (I presume this to do with the directory being empty). This might apply to some other web-browsers/unzipping programs too (though I have yet to find another one). If you find that the gunther/uploads directory is missing you can just create it yourself - it should just be an empty directory.

The directory 'gunther' will be the root of your Gunther website. You can move the entire contents of this directory anywhere you like as long as it is all accessible via the web. You might want to move everything out of the 'gunther' directory and run Gunther at the top level of your site.

4. Now we want to initialise and log-in to the new Gunther installation so we can start building a site. You should then open your browser and point it at your Gunther installation. The main index.php file should load and you should be forwarded to a log-in page. On a new installation the log-in page will ask you to provide an administrator user name and password. The user name can be anything you like. When you have entered the user name and password and logged in you will be presented with the 'Manage Website' screen. You will see an empty list of pages.

5. Create your first page! You should create a page called 'index'. This will be the front page and the page that the index.php script forwards to for normal visitors.

6. Once logged in you will stay logged in until you close your browser. To log in as the administrator later on, you must browser to the address of your Gunther website and add '/admin/' to the end of the URL. e.g.: http://www.mysite.com/gunther/admin or http://www.mysite.com/admin
  Last modified: Fri, 18 February 2005 (01:14:32 AM)