localhost_frssoft/ bloat
1
0
Fork 0
mirror of https://gitea.phreedom.club/localhost_frssoft/bloat.git synced 2024-11-16 09:49:21 +02:00
Code Issues Packages Projects Releases Wiki Activity
bloat/INSTALL

43 lines
1.4 KiB
Plaintext
Raw Permalink Normal View History

Add install instructions
2020-02-02 13:37:49 +02:00
Installation
Update makefile and install instructions Updated makefile now performs installation without overwriting config and database directory.
2020-02-18 23:48:21 +02:00
1. Get the source
Add install instructions
2020-02-02 13:37:49 +02:00
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
Update makefile and install instructions Updated makefile now performs installation without overwriting config and database directory.
2020-02-18 23:48:21 +02:00
Install GO from your system's package manager or from https://golang.org/dl.
Then run make to compile the source.
Add install instructions
2020-02-02 13:37:49 +02:00
$ make
# make install
This will perform a system wide installation of bloat. By default, it will
Update makefile and install instructions Updated makefile now performs installation without overwriting config and database directory.
2020-02-18 23:48:21 +02:00
install the binary in /usr/local/bin and data files in /usr/local/share/bloat.
You can change these paths by editing the Makefile.
Change config file lookup - Look for both local and global config file - Directly generate the global config file with make install
2022-01-02 12:52:15 +02:00
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".
Don't overwrite global config file on make install
2022-02-10 18:03:44 +02:00
# cp bloat.gen.conf /etc/bloat.conf
Change config file lookup - Look for both local and global config file - Directly generate the global config file with make install
2022-01-02 12:52:15 +02:00
# $EDITOR /etc/bloat.conf
Update makefile and install instructions Updated makefile now performs installation without overwriting config and database directory.
2020-02-18 23:48:21 +02:00
Add install instructions
2020-02-02 13:37:49 +02:00
5. Run the binary
Use cookies for session storage Remove the server side session storage and store all the session related data in the client side cookies. This decreases the exposure of the auth tokens. It also simplifies the installation process as bloat no longer requires write access to the filesystem. This is a breaking change, all the existing sessions will stop working.
2022-10-25 16:40:49 +03:00
$ bloat
Update makefile and install instructions Updated makefile now performs installation without overwriting config and database directory.
2020-02-18 23:48:21 +02:00
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.