updated as of: March 30, 2015
last author: Andy Theuninck
NB: File paths are suggestions for clarify. Fannie can go anywhere on your server.
Documentation is for installing fannie locally. Replace localhost with a proper
URL if that's not the case.
The latest documentation can be found on the Project Wiki
The information below may be out of date.
Exact steps will vary by OS. Skip ahead if you know your way around a LAMP/WAMP stack.
Start Apache and MySQL services. Windows-based installers probably did this for
you. On linux, try "/etc/init.d/mysqld start" or "/etc/init.d/httpd start". The
exact name of the init script may vary depending on your distribution.
Configure Apache and MySQL to start at boot-time. Again, Windows likely did
this for you. If not, right click my Computer and see Manage => Services.
On Red Hat-ish linux distros, "/sbin/chkconfig/[init script name] on" should
do the trick. On Debian/Ubuntu, seek documentation on service management...
Sanity check: make sure Apache+PHP is in business. Copy this into a file named
- Install Apache Web Server. Version 2+ recommended
- Install PHP. Version 5+ strongly recommended. PHP4 will probably work, but it's not guaranteed.
- Install MySQL database server. Version 5+ required
Place your index.php in Apache's web root. This is probably:
Point a browser at http://localhost/. If you get a big mess of PHP installation
info, you're in business. If you get an Apache place holder page, either PHP isn't
enabled (fiddle with Apache configuration), or the index.php file isn't in the
right place (check DocumentRoot in Apache configuration). If you get a connection
refused error, Apache probably isn't running. For other problems, you're on your
- Windows: C:\Program Files\Apache Group\Apache 2\htdocs\
- Linux: /var/www/html/
- Mac: /Library/WebServer/Documents/
- Place the fannie directory in your web root. See prerequisites
for OS-specific possibilities. If you made an index.php file for
testing purposes, the fannie directory should go in the same place.
- Point a browser at http://localhost/fannie/install/. This page is
used for initial fannie installation and configuration options.
Fannie is now installed and functional, albeit on a very basic level
- The install script tries to write the configuration file, http://localhost/fannie/config.php. It'll tell you what the web server's uid is and whether or not the config file is writable. If it isn't, you need to fix that or none of the settings wills save.
- Enter database connection information under the Main Server heading. In a basic setup, the server host is localhost, the type is MySQL, the database username is root and hopefully you know the password. You can name the operational and transaction databases whatever you like or just accept the defaults.
- Click Re-Run at the bottom of the page. This may take a little while as the databases get built. (Depending on your hardware and software configuration, you might even hit a PHP time/memory error. Try refreshing, maybe even a couple times.) If MySQL is running and the connection settings are correct, you should see
both Testing Connection lines under Main Server showing Succeeded.