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 and copy the config file Edit the generated config file to you liking and then copy it to the default config location. Comments in the config file describe what each config value does. For most cases, you only need to change the value of "client_website". $ $EDITOR bloat.def.conf # cp bloat.def.conf /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.