(This page is a work in progress)
FusionForge is mainly developed on Linux systems, but it should run on other Unix variants as well. The minimal required components are Apache 2, PHP 5 and PostgreSQL 8.x. Other components may be needed depending on the extra features you need: Mailman for mailing-lists, CVS or SVN for version control, and so on.
There are *.deb packages available for Debian and derivatives such as Ubuntu. The official Debian repositories contain packages of the latest FusionForge release (4.7.2) for Debian unstable. The "experimental" section will also contain snapshots of the release-candidates for 4.8 during the stabilisation period. Users of Ubuntu or other versions of Debian will find instructions on how to get the packages on Installing/DebianRepositories or Installing/UbuntuRepositories ).
- .rpm packages are being worked on, and they will be advertised as soon as they're considered ready.
If you have a server you want to fully dedicate to FusionForge, then the installation CD could be for you: just boot the server on it, and it'll perform an automated installation of Debian + FusionForge. Grab the image at Installing/InstallCD
Also easy to use is the VMware image, which you'll also find at Installing/VMwareImage
Finally, there's the non-packaged way of installing FusionForge: grab the tarball at Installing/RedhatCentosTarballs , then run the install.sh script.
Debian Lenny Installation Procedure
- BASIC PREPARATIONS
- Create a hostname for your web site (ex. FORGE.YOURSITE.COM)
- Configure Apache to answer to requests for this hostname
- Test Apache by browsing to your URL to see the default Apache "It works." page
- Do the following steps as root user
- INSTALL EXIM4
apt-get update apt-get install exim4
- INSTALL MAILMAN
apt-get install mailman
- Create required mailman list and start mailman
newlist mailman /etc/init.d/mailman start
- INSTALL POSTGRESQL(latest version)
apt-get install postgresql
- Test using Create Language:
su postgres createlang plpgsql template1 exit
- Change authentication method for pgsql:
cp /etc/postgresql/8.3/main/pg_hba.conf /etc/postgresql/8.3/main/pg_hba.confbak nano /etc/postgresql/8.3/main/pg_hba.conf
All other connections by UNIX sockets local all all '''ident sameuser''' All IPv4 connections from localhost host all all 127.0.0.1 255.255.255.255 '''ident sameuser''' All IPv6 localhost connections host all all ::1 ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff '''ident sameuser''' host all all ::ffff:127.0.0.1/128 '''ident sameuser'''
All other connections by UNIX sockets local all all '''password''' All IPv4 connections from localhost host all all 127.0.0.1 255.255.255.255 '''password''' All IPv6 localhost connections host all all ::1 ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff '''password''' host all all ::ffff:127.0.0.1/128 '''password'''
- INSTALL PHP5
Edit /etc/apt/sources.list and add the following and save:
# PHP5 Source deb http://packages.dotdeb.org stable all deb-src http://packages.dotdeb.org stable all
As the root user, execute:
apt-get update apt-get install libapache2-mod-php5 libapache2-mod-perl2 php5 php5-cli php5-common php5-curl php5-dev php5-gd php5-imap php5-ldap php5-mhash php5-mysql php5-odbc php5-xsl
Some packages may fail, but as they do, remove them from your list of installations until apt-get install runs successfully. There are only a couple of core modules that are required.
To check your version of PHP, issue the following command:
To test PHP, do the following:
cd /var/www (if www is not your webroot, substitute) nano test.php (creates file called test.php)
Add the following to the file:
<?php phpinfo(); ?>
Browse to your webroot with your web browser: http://yoursite.com/test.php You should see php configuration information on the screen. If you do, then you can be certain php is running on your server and is being loaded into Apache correctly. For security purposes, make sure you DELETE the test.php file immediately.
- INSTALL SVN
apt-get install subversion
- INSTALL WEBMIN
deb http://download.webmin.com/download/repository sarge contrib apt-get update apt-get install webmin
wget http://prdownloads.sourceforge.net/webadmin/webmin_1.470_all.deb dpkg --install webmin_1.470_all.deb
If Debian complains about missing dependencies, you can install them with the command:
apt-get install perl libnet-ssleay-perl openssl libauthen-pam-perl libpam-runtime libio-pty-perl libmd5-perl
Download POSTGRESQL Webmin Module This will help in administering the database via a GUI if you aren't comfortable using commands.
- INSTALL FUSIONFORGE
Visit Installing/DebianRepositories or Installing/UbuntuRepositories for additional install packages
deb http://fusionforge.fusionforge.org/debian lenny main deb-src http://fusionforge.fusionforge.org/debian lenny main wget -q http://fusionforge.fusionforge.org/key -O- | sudo apt-key add - apt-get update apt-get install gforge
Package Maintainer's Version for all prompts
- INSTALL SCM PLUGIN
apt-get install gforge-plugin-scmsvn
- INSTALL MEDIAWIKI PLUGIN
apt-get install gforge-plugin-mediawiki
Enable wiki for project by navigating to Project>Admin>Edit Public Info and check off the box for Mediawiki
Procedure by Narayan Raum and Chris Barnes at the University of Florida.
Back to FusionForge