Installing Jirafeau on Debian Latest
Jirafeau is a free and open-source file sharing application that allows users to securely share files with others. In this tutorial, we will be installing Jirafeau on Debian latest version.
Prerequisites
Before you begin with the installation, make sure the following prerequisites are met:
- A Debian operating system installed on your machine or server
- A user account with sudo privileges
- A web server such as Apache or Nginx
- PHP installed on your system, version 7.2 or higher
- PHP extensions
gd,zip, andmbstringinstalled - Allow the port
80and443on your firewall
Step 1: Download Jirafeau
First, download the latest version of Jirafeau from the official GitLab repository using the following command:
sudo wget https://gitlab.com/mojo42/Jirafeau/-/archive/master/Jirafeau-master.tar.gz
Once the download is complete, extract the downloaded archive using the following command:
sudo tar -zxvf Jirafeau-master.tar.gz
Step 2: Install Jirafeau Dependencies
Next, you need to install Jirafeau dependencies using the following command:
sudo apt-get install composer sqlite3 php-sqlite3
Step 3: Configure the Web Server
Assuming that you have already installed Apache or Nginx web server in Debian. We will create a virtual host configuration file for Jirafeau.
Create a new virtual host file under /etc/apache2/sites-available/ or /etc/nginx/sites-available/ depending on the server you have installed.
sudo nano /etc/apache2/sites-available/jirafeau.conf
or
sudo nano /etc/nginx/sites-available/jirafeau.conf
Then, add the following configuration for Apache:
<VirtualHost *:80>
ServerName jirafeau.example.com
DocumentRoot /var/www/html/Jirafeau-master
<Directory /var/www/html/Jirafeau-master>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Or add the following configuration for Nginx:
server {
listen 80;
server_name jirafeau.example.com;
root /var/www/html/Jirafeau-master;
index index.php;
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
location / {
try_files $uri $uri/ =404;
}
location ~* \.(gif|jpg|jpeg|png|bmp|swf|flv|mp4|ico)$ {
expires 30d;
access_log off;
}
location ~ /\.ht {
deny all;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi_params;
}
}
Step 4: Install Jirafeau
Now, navigate to the Jirafeau directory and run the following command to install Jirafeau:
composer install
Then, set the correct permissions on Jirafeau directory:
sudo chown www-data:www-data /var/www/html/Jirafeau-master/ -R
sudo chmod 755 /var/www/html/Jirafeau-master/ -R
Step 5: Configure Jirafeau
Next, navigate to the config/ directory and rename the config.sample.php to config.php.
cd /var/www/html/Jirafeau-master/config
cp config.sample.php config.php
Edit the config.php file and update the following information:
define('JIRA_CONFFILE', '/var/www/html/Jirafeau-master/config.php'); // full path to config.php
define('JIRA_TOKFILE', '/var/www/html/Jirafeau-master/.token_php'); // must be writable by webserver
define('JIRA_DATADIR', '/var/www/html/Jirafeau-master/data'); // upload dir. Must be writable by webserver
define('JIRA_TMPDIR', '/var/www/html/Jirafeau-master/tmp'); // temp dir for excess files. Must be writable by webserver
And save the file.
Step 6: Access Jirafeau
Finally, restart Apache or Nginx and launch your web browser and type the following URL:
http://jirafeau.example.com
You will be redirected to the installation process.
Follow the on-screen instructions to complete the installation.
Conclusion
In this tutorial, we have successfully installed Jirafeau on Debian latest version. You can now use Jirafeau to securely share files with others.