{"id":2228,"date":"2023-11-14T12:11:54","date_gmt":"2024-03-11T21:24:22","guid":{"rendered":""},"modified":"2025-02-02T00:46:18","modified_gmt":"2025-02-01T23:46:18","slug":"how-to-install-helpy-customer-helpdesk-on-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-helpy-customer-helpdesk-on-ubuntu-22-04\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Helpy Customer Helpdesk on Ubuntu 22.04"},"content":{"rendered":"

\u00a0<\/p>\n<\/p>\n

\n

\u00a0<\/h1>\n<\/header>\n
\n

Helpy is an open-source customer support helpdesk platform that provides a simple and effective way to manage customer inquiries and support tickets. In this guide, we will walk you through the steps to install Helpy on Ubuntu 22.04. Whether you\u2019re setting it up for a local deployment or using a for hosting, this tutorial will help you get Helpy up and running.<\/p>\n

\n

Step 1: Update Your System<\/h2>\n

Before starting the installation, it\u2019s important to update your Ubuntu 22.04 system to ensure that all software packages are up to date. Run the following commands:<\/p>\n

sudo apt update && sudo apt upgrade<\/code><\/pre>\n
This will help ensure that you are working with the latest security patches and software updates. Keeping your system updated is essential whether you\u2019re hosting Helpy locally or on a UK Windows VPS<\/a>.<\/p>\n<\/section>\n
\n
Step 2: Install Required Dependencies<\/h2>\n
Helpy requires several dependencies, including Ruby, Node.js, PostgreSQL, and Redis. Install these dependencies by running the following commands:<\/p>\n
sudo apt install ruby-full nodejs postgresql postgresql-contrib redis-server build-essential libpq-dev<\/code><\/pre>\n
These packages are necessary to set up the Helpy platform, whether you\u2019re deploying it locally or on a Windows VPS hosting UK<\/a> environment.<\/p>\n<\/section>\n
\n
Step 3: Install Rails<\/h2>\n
Helpy is built on the Ruby on Rails framework, so you need to install Rails. First, install Bundler, a package manager for Ruby, with the following command:<\/p>\n
sudo gem install bundler<\/code><\/pre>\n
Then, install Rails using the gem command:<\/p>\n
sudo gem install rails -v 6.1.4<\/code><\/pre>\n
Rails is now installed and ready to be used in setting up Helpy. This installation is required whether you are hosting Helpy locally or on a VPS Windows VPS Servers<\/a> setup.<\/p>\n<\/section>\n
\n
Step 4: Configure PostgreSQL<\/h2>\n
Helpy uses PostgreSQL as its database. To configure PostgreSQL, first log in to the PostgreSQL shell:<\/p>\n
sudo -u postgres psql<\/code><\/pre>\n
Create a new database and user for Helpy:<\/p>\n
\r\nCREATE DATABASE helpydb;\r\nCREATE USER helpyuser WITH PASSWORD 'yourpassword';\r\nALTER ROLE helpyuser SET client_encoding TO 'utf8';\r\nALTER ROLE helpyuser SET default_transaction_isolation TO 'read committed';\r\nALTER ROLE helpyuser SET timezone TO 'UTC';\r\nGRANT ALL PRIVILEGES ON DATABASE helpydb TO helpyuser;\r\n\\q\r\n            <\/code><\/pre>\n
This step ensures that PostgreSQL is configured to work with Helpy. It applies to both local and cloud environments, such as Microsoft SQL VPS Windows<\/a>.<\/p>\n<\/section>\n
\n
Step 5: Download and Set Up Helpy<\/h2>\n
Next, you need to download the latest version of Helpy from GitHub. Navigate to your desired installation directory, for example \/opt<\/code>:<\/p>\n
cd \/opt<\/code><\/pre>\n
Clone the Helpy repository:<\/p>\n
sudo git clone https:\/\/github.com\/helpyio\/helpy.git<\/code><\/pre>\n
Navigate into the Helpy directory and install the necessary dependencies using Bundler:<\/p>\n
\r\ncd helpy\r\nbundle install\r\n            <\/code><\/pre>\n
Once the dependencies are installed, set up the Helpy database configuration:<\/p>\n
sudo nano config\/database.yml<\/code><\/pre>\n
Update the file with your PostgreSQL database credentials:<\/p>\n
\r\nproduction:\r\n  adapter: postgresql\r\n  encoding: unicode\r\n  database: helpydb\r\n  pool: 5\r\n  username: helpyuser\r\n  password: yourpassword\r\n  host: localhost\r\n            <\/code><\/pre>\n
Save and close the file.<\/p>\n<\/section>\n
\n
Step 6: Initialize the Database<\/h2>\n
After configuring the database, initialize it by running the following commands:<\/p>\n
\r\nrails db:create RAILS_ENV=production\r\nrails db:migrate RAILS_ENV=production\r\nrails assets:precompile RAILS_ENV=production\r\n            <\/code><\/pre>\n
These commands set up the Helpy database and prepare the application for production. Whether you\u2019re using Helpy on a local server or hosting on a Windows VPSVirtual Private Server hosting<\/a> environment, this step is necessary.<\/p>\n<\/section>\n
\n
Step 7: Start Helpy<\/h2>\n
You can now start Helpy using the Puma server, which is bundled with the Rails framework. Run the following command to start Helpy:<\/p>\n
rails s -e production<\/code><\/pre>\n
Helpy will start running on the default port 3000. To access it, open your browser and navigate to:<\/p>\n
http:\/\/your-server-ip:3000<\/code><\/pre>\n
This local deployment setup works whether you\u2019re hosting Helpy on your system or a VPS Windows VPShosting<\/a> platform.<\/p>\n<\/section>\n
\n
Step 8: Configure Nginx as a Reverse Proxy<\/h2>\n
For production environments, it’s recommended to use Nginx as a reverse proxy for Helpy. Create an Nginx configuration file for Helpy:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/helpy<\/code><\/pre>\n
Add the following configuration:<\/p>\n
\r\nserver {\r\n    listen 80;\r\n    server_name your-server-ip;\r\n\r\n    location \/ {\r\n        proxy_pass http:\/\/127.0.0.1:3000;\r\n        proxy_set_header Host $host;\r\n        proxy_set_header X-Real-IP $remote_addr;\r\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n        proxy_set_header X-Forwarded-Proto $scheme;\r\n    }\r\n\r\n    location \/assets\/ {\r\n        alias \/opt\/helpy\/public\/assets\/;\r\n    }\r\n}\r\n            <\/code><\/pre>\n
Save the file and enable the site:<\/p>\n
\r\nsudo ln -s \/etc\/nginx\/sites-available\/helpy \/etc\/nginx\/sites-enabled\/\r\nsudo systemctl restart nginx\r\n            <\/code><\/pre>\n
Nginx is now configured as a reverse proxy for Helpy, providing a production-ready setup. This is suitable whether you are running Helpy locally or on a Windows VPS hosting UK<\/a> platform.<\/p>\n<\/section>\n