aboutsummaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorr <r@freesoftwareextremist.com>2020-02-18 21:48:21 +0000
committerr <r@freesoftwareextremist.com>2020-02-18 21:48:21 +0000
commit39a3bb7f3566ca0b7020d10abd5d5815096b49cb (patch)
tree55527f5b3a508c1f869c533a8f0eef4ff944cf9c /INSTALL
parentd028eb507733bde55c2c79740c699672d623fe07 (diff)
downloadbloat-39a3bb7f3566ca0b7020d10abd5d5815096b49cb.tar.gz
bloat-39a3bb7f3566ca0b7020d10abd5d5815096b49cb.zip
Update makefile and install instructions
Updated makefile now performs installation without overwriting config and database directory.
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL79
1 files changed, 33 insertions, 46 deletions
diff --git a/INSTALL b/INSTALL
index 89868d5..032f612 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,62 +1,49 @@
Installation
-Commands starting with # are to be is to run as root.
-
-1. Get the sources
+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.
+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, data files in /var/bloat and config
-file in /etc. You can change these paths by editing the Makefile.
-
-3. Edit the config file
-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 /etc/bloat.conf
-
-4. Create a separate user account to run bloat
-It's not required to create a separate user account, but it's a good practice
-to do so.
+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 Makefile.
+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 the service at
-system startup.
-
-6. Setup TLS
-You can use an HTTP server as a reverse proxy to serve bloat over HTTPS. Here's
-a config file snippet for nginx:
-`
-server {
- server_name bloat.example.com;
- location / {
- proxy_pass http://127.0.0.1:8080;
- }
-}
-server {
- server_name bloat.example.com;
- listen 443 ssl;
-
- ssl_trusted_certificate /etc/ssl/example.com.crt;
- ssl_certificate /etc/ssl/example.com.fullchain.pem;
- ssl_certificate_key /etc/ssl/private/example.com.key;
-
- location / {
- proxy_pass http://127.0.0.1:8080;
- }
-}
-`
-This configuration accepts for connections for bloat.example.com (specified by
-"client_website" in config) over both HTTP and HTTPS and forwards them to
-bloat's listen address (specified by "listen_address" in config).
+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.