Installation 1. Get the source Get the source code by running $ git clone https://git.freesoftwareextremist.com/bloat You can also download the latest source tarball from the URL "https://git.freesoftwareextremist.com/bloat/snapshot/bloat-master.tar.gz" 2. Build and install Install GO from your system's package manager or from https://golang.org/dl. Then run make to compile the source. $ make # make install This will perform a system wide installation of bloat. By default, it will install the binary in /usr/local/bin and data files in /usr/local/share/bloat. You can change these paths by editing the Makefile. 3. Edit the config file bloat looks for a file named bloat.conf in the working directory and /etc/bloat in that order. You can also specify another file by using the -f flag. Comments in the config file describe what each config value does. For most cases, you only need to change the value of "client_website". # cp bloat.gen.conf /etc/bloat.conf # $EDITOR /etc/bloat.conf 4. Create database directory Create a directory to store session information. Optionally, create a user to run bloat and change the ownership of the database directory accordingly. # mkdir /var/bloat # useradd _bloat # chown -R _bloat:_bloat /var/bloat Replace /var/bloat with the value you specified in the config file. 5. Run the binary # su _bloat -c bloat Now you should create an init script to automatically start bloat at system startup. Update Either run git pull to fetch the updated source or download the latest tarball from the URL mentioned in the installation step. Then run make to install the updated binary and data files $ git pull $ make # make install Note: Commands starting with # are to be is to run as root.