How to Install Gladys on Ubuntu Server

Gladys is an open-source home automation platform that allows users to automate their homes using various technologies. In this tutorial, we will guide you through the steps to install Gladys on Ubuntu Server.

Prerequisites

To install Gladys, you need to have a few things set up on your Ubuntu Server:

Ubuntu Server Latest
Node.js v12 or later
PostgreSQL database

Step 1: Update Ubuntu

Before installing Gladys, it is best to update Ubuntu to ensure that you have the latest security patches and software updates.

To update Ubuntu, run the following commands:

sudo apt-get update
sudo apt-get upgrade

Step 2: Install Node.js

To install Node.js on Ubuntu, you can use the NodeSource repository. Follow the steps below:

Add the NodeSource APT repository:

curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -

Install Node.js:
```
sudo apt-get install -y nodejs
```

Once Node.js is installed, verify the version using the following command:

node -v

Step 3: Install PostgreSQL

To install PostgreSQL on Ubuntu, run the following command:

apt-get install postgresql postgresql-contrib

Once the installation is complete, you need to create a PostgreSQL user and database for Gladys.

Step 4: Create a PostgreSQL User and Database for Gladys

To create a PostgreSQL user and database for Gladys, follow the steps below:

Log in to the PostgreSQL shell:
```
sudo -u postgres psql
```
Create a new user for Gladys:
```
CREATE USER gladys WITH PASSWORD 'password';
```
Replace 'password' with a strong password for Gladys.
Create a new database for Gladys:
```
CREATE DATABASE gladys OWNER gladys;
```

Once the user and database are created, exit the PostgreSQL shell:

\q

Step 5: Download and Install Gladys

To download and install Gladys, follow the steps below:

Go to the Gladys website and download the latest version of Gladys.
Extract the Gladys archive:
```
tar xvzf gladys-v4.3.0.tar.gz
```
Navigate to the Gladys directory:
```
cd gladys
```
Install Gladys:
```
npm install --production
```

Step 6: Configure Gladys

To configure Gladys, you need to set up the database connection and the server IP address.

Create a .env file:
```
cp .env.sample .env
```
Edit the .env file:
```
nano .env
```
Set the following parameters:
- DATABASE_URL: This is the PostgreSQL database URL. Replace YOUR_PASSWORD with the password you set for the Gladys user:
```
DATABASE_URL=postgres://gladys:YOUR_PASSWORD@localhost/gladys
```
- SERVER_URL: This is the IP address or domain name of your Ubuntu server. Make sure to include the protocol (http or https) and port number (if necessary):
```
SERVER_URL=http://192.168.1.100:8080
```
Save the .env file and exit the editor.

Step 7: Start Gladys

To start Gladys, simply run the following command:

npm start

Gladys should now be running on your Ubuntu server. You can access Gladys by opening a web browser and navigating to the server URL you specified in the .env file.