INSTALL 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. Installation
  2. 1. Get the source
  3. Get the source code by running
  4. $ git clone https://git.freesoftwareextremist.com/bloat
  5. You can also download the latest source tarball from the URL
  6. "https://git.freesoftwareextremist.com/bloat/snapshot/bloat-master.tar.gz"
  7. 2. Build and install
  8. Install GO from your system's package manager or from https://golang.org/dl.
  9. Then run make to compile the source.
  10. $ make
  11. # make install
  12. This will perform a system wide installation of bloat. By default, it will
  13. install the binary in /usr/local/bin and data files in /usr/local/share/bloat.
  14. You can change these paths by editing the Makefile.
  15. 3. Edit and copy the config file
  16. Edit the generated config file to you liking and then copy it to the default
  17. config location. Comments in the config file describe what each config value
  18. does. For most cases, you only need to change the value of "client_website".
  19. $ $EDITOR bloat.def.conf
  20. # cp bloat.def.conf /etc/bloat.conf
  21. 4. Create database directory
  22. Create a directory to store session information. Optionally, create a user
  23. to run bloat and change the ownership of the database directory accordingly.
  24. # mkdir /var/bloat
  25. # useradd _bloat
  26. # chown -R _bloat:_bloat /var/bloat
  27. Replace /var/bloat with the value you specified in the config file.
  28. 5. Run the binary
  29. # su _bloat -c bloat
  30. Now you should create an init script to automatically start bloat at system
  31. startup.
  32. Update
  33. Either run git pull to fetch the updated source or download the latest tarball
  34. from the URL mentioned in the installation step. Then run make to install the
  35. updated binary and data files
  36. $ git pull
  37. $ make
  38. # make install
  39. Note: Commands starting with # are to be is to run as root.