updated as of: March 30, 2015
last author: Andy Theuninck
The latest documentation can be found on the Project Wiki. The information below may be out of date.
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.


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 index.php:

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 own.

Installing Fannie

  1. 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.
  2. Point a browser at http://localhost/fannie/install/. This page is used for initial fannie installation and configuration options.
  3. Fannie is now installed and functional, albeit on a very basic level