Hitobito is a web-based software solution for managing membership-based organizations. You can install Hitobito on Debian by following these simple steps:
You need to have the following in place to install Hitobito successfully:
sudo apt update
sudo apt upgrade
sudo apt install git
git clone https://github.com/hitobito/hitobito.git hitobito
sudo apt install php php-common php-mysql php-pgsql php-curl php-gd php-json php-mbstring php-xml
cp config/database.yml.example config/database.yml
nano config/database.yml
Change the database configuration parameters according to your setup. For example, if you are using MySQL, set the following parameters:
adapter: mysql2
database: hitobito
username: your_mysql_username
password: your_mysql_password
host: localhost
RAILS_ENV=production bundle exec rake db:create
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake assets:precompile
Create an Apache virtual host configuration file for Hitobito:
sudo nano /etc/apache2/sites-available/hitobito.conf
and paste the following configuration:
<VirtualHost *:80>
ServerName your.domain.com
DocumentRoot /path/to/hitobito/public
<Directory /path/to/hitobito/public>
Options -MultiViews
AllowOverride All
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [QSA,L]
</Directory>
ErrorLog ${APACHE_LOG_DIR}/hitobito_error.log
CustomLog ${APACHE_LOG_DIR}/hitobito_access.log combined
</VirtualHost>
Change the ServerName
, DocumentRoot
, and <Directory>
paths according to your setup.
Enable the new virtual host with:
sudo a2ensite hitobito.conf
Restart the Apache service:
sudo systemctl restart apache2
Open your web browser and navigate to http://your.domain.com
. You should see the Hitobito login screen. Use the default administrator account admin@hitobito.com
with password secretsauce
to log in and configure your organization.
Congratulations! You have successfully installed Hitobito on your Debian system.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!