Abe Installation

From auWiki
Jump to: navigation, search

Abe Personal Finance runs PHP on Apache HTTP Server on Linux with a MySQL database. For Ubuntu Linux you can make sure you have everything with this command (not tested; might need more):

sudo apt-get install apache2 mysql-server php5 libapache2-mod-php5

Abe does not include any security, so should not be installed on an Internet-facing server without adequate security set up separately. This guide does not provide security instructions.

Install Abe

Installing Abe is a matter of getting the files into a directory the web server is set up to host. It can be the website document root, or it can be a subdirectory of document root. The default document root for Ubuntu is /var/www/html/.

Git or SVN can get the latest files from the Abe GitHub repository and also easily download updates, or download it as a zip and extract it.

Git

By default, cloning the GitHub repository with git will put everything in a directory named abe. To install to /var/www/html/abe/ use the following commands:

cd /var/www/html/
git clone https://github.com/misterhaan/abe.git

That method allows for other web applications to install to other subdirectories of the default website. It’s the same way MythWeb will install from the Mythbuntu apt repository.

If you don’t want the abe subdirectory, specify the path you want to clone to at the end of the git command instead. This example installs Abe directly to the default document root:

git clone https://github.com/misterhaan/abe.git /var/www/html/

To update, get into your abe directory and run git pull:

cd /var/www/html/abe/
git pull

Subversion

If your server has svn but not git, you can use svn to checkout from GitHub much like using git to clone from GitHub. Unfortunately it will put all the code inside a subdirectory named trunk, and adding /trunk to the URL doesn’t fix that. Here are the checkout and update commands. Leave off the abe/ to use /var/www/html/ directly:

svn co https://github.com/misterhaan/abe.git/branches/master /var/www/html/abe/
svn update /var/www/html/abe/

Zip Download

GitHub provides a zip download of the repository contents. Visit https://github.com/misterhaan/abe in a browser and click the green Clone or download button to pop up a box with a Download ZIP link in the bottom right. Either use that link to download and then transfer to the Linux server, or use wget from the Linux server. Then extract the file and it will put everything inside a directory named abe-master.

cd /var/www/html/
wget https://github.com/misterhaan/abe/archive/master.zip
unzip master.zip
mv abe-master/ abe
rm master.zip