How to Install OpenSupports on Manjaro

OpenSupports is an open-source ticketing and customer support system that allows you to manage customer service tickets efficiently. In this tutorial, we will guide you through the process of installing OpenSupports on Manjaro.

Prerequisites

Before we begin, make sure that you have the following prerequisites:

  • A Manjaro-based system
  • A web server (Apache or Nginx)
  • PHP 7.2 or later
  • MySQL database

Step 1: Downloading OpenSupports

First, download the latest version of OpenSupports from their official website. You can do this by navigating to the OpenSupports website and selecting the 'Download' button.

Once the download is complete, extract the files to your desired directory using the following command:

tar -xzf opensupports-x.x.x.tar.gz

Note: Replace 'x.x.x' with the version number of the file you downloaded.

Step 2: Setting up the Web Server

You'll need to create a new virtual host configuration file for OpenSupports. Here's the example of how you can do it in Apache:

sudo nano /etc/httpd/conf.d/opensupports.conf

Use the following configuration for OpenSupports:

<VirtualHost *:80>
    ServerName yourdomain.com
    ServerAdmin [email protected]
    DocumentRoot /var/www/opensupports

    <Directory /var/www/opensupports/>
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog /var/log/httpd/opensupports-error.log
    CustomLog /var/log/httpd/opensupports-access.log combined
</VirtualHost>

Step 3: Installing Required PHP Extensions

Before proceeding with the installation of OpenSupports, you must install some required PHP extensions. Execute the following command in your terminal to install all necessary PHP extensions:

sudo pacman -S php php-gd php-mcrypt php-pear php-zip php-mysql

Step 4: Configuring MySQL

Once you've installed the necessary extensions, create a new MySQL database and user for OpenSupports. You can do this by executing the following commands:

sudo mysql
CREATE DATABASE opensupports;
GRANT ALL PRIVILEGES ON opensupports.* TO 'opensupportsuser'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;

Note: Replace 'opensupportsuser' and 'password' with your desired username and password.

Step 5: Configuring OpenSupports

Now that you have everything in place, it's time to configure OpenSupports. Navigate to the OpenSupports directory and copy the example configuration files:

cd /var/www/opensupports
cp config/config.dist.php config/config.php
cp config/database.dist.php config/database.php

Next, modify the 'config.php' file with your desired configuration settings. Here's an example of how it should look:

<?php
define('VERSION', 'x.x.x');
define('APP_NAME', 'OpenSupports');

define('HTTP_HOST', 'yourdomain.com');
define('HTTP_PORT', '80');
define('HTTP_PROTOCOL', 'http');

define('DEFAULT_APP_LANG', 'en');

define('MAX_UPLOAD_SIZE', 2*1024*1024);
define('MAX_UPLOAD_FILES', 5);
define('ALLOWED_UPLOAD_EXTENSIONS', 'png,jpg,jpeg,gif,bmp,zip,csv,txt,doc,docx,xls,xlsx,ppt,pptx,pdf');

define('SMTP_SERVER', '');
define('SMTP_PORT', '');
define('SMTP_ENCRYPTION', '');
define('SMTP_USERNAME', '');
define('SMTP_PASSWORD', '');

define('CHATBOX_ENABLED', true);
define('CHATBOX_FREE_CHAT', true);

define('GOOGLE_CAPTCHA_SITE_KEY', '');
define('GOOGLE_CAPTCHA_SECRET_KEY', '');

After modifying the 'config.php' file, edit the 'database.php' file with your database settings:

<?php

define('DB_HOST', 'localhost');
define('DB_NAME', 'opensupports');
define('DB_USERNAME', 'opensupportsuser');
define('DB_PASSWORD', 'password');
define('DB_PORT', '3306');

define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATION', 'utf8mb4_unicode_ci');

Step 6: Accessing OpenSupports

That's it! Now OpenSupports is fully installed and ready to use. You can access it by visiting your server's domain name or IP address in your web browser:

http://yourdomain.com

or

http://your-server-ip-address

Once you access the OpenSupports login page, enter your administrator credentials to start using the platform:

Username: admin
Password: admin123

Note: It is highly recommended to change the default credentials once you access the OpenSupports dashboard.

Conclusion

Congratulations! You have now successfully installed OpenSupports on your Manjaro-based server. You can now customize your support center and start managing customer tickets efficiently. If you encounter any issues during the installation process, refer to the official OpenSupports documentation for further assistance: https://github.com/opensupports/opensupports#manual-installation-guide.