Easy!Appointments is an open-source web-based appointment scheduler that manages appointments efficiently. In this tutorial, we will walk you through the installation of Easy!Appointments on POP! OS Latest.
Before installing Easy!Appointments, ensure that your POP! OS Latest system is up-to-date by running the following commands in the terminal:
sudo apt update
sudo apt upgrade
To run Easy!Appointments, we need to install some dependencies. These dependencies include Apache server, PHP, MySQL server, and some PHP modules. Run the following command to install the packages:
sudo apt install apache2 php mysql-server php-mysql php-curl php-gd php-xml php-mbstring
During the installation, you will be prompted to create a MySQL root password. Remember this password as you will need it later.
Next, navigate to the Easy!Appointments download page https://easyappointments.org/download/, and get the latest stable release (zip archive) to your POP! OS Latest system using the following command in the terminal:
wget https://github.com/alextselegidis/easyappointments/releases/download/1.5.3/easyappointments-1.5.3.zip
After the download is complete, extract the zip file using the following command:
unzip easyappointments-1.5.3.zip
This command will create a new directory called easyappointments.
We need to create an Apache virtual host configuration file for Easy!Appointments. Run the following command to create a file called easyappointments.conf in the /etc/apache2/sites-available/ directory:
sudo nano /etc/apache2/sites-available/easyappointments.conf
Add the following configuration in the file:
<VirtualHost *:80>
ServerName your_domain_name
DocumentRoot /var/www/easyappointments
<Directory /var/www/easyappointments>
Options Indexes FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Replace your_domain_name with your actual domain name.
Save and close the file by pressing Ctrl + X, then Y, and then ENTER.
Move the easyappointments directory to the /var/www/ directory using the following command in the terminal:
sudo mv easyappointments /var/www/
Change the ownership of the easyappointments folder to the www-data user using the following command:
sudo chown -R www-data:www-data /var/www/easyappointments
We need to create a MySQL database for Easy!Appointments to store its data. Run the following command to log in to the MySQL console:
sudo mysql -u root -p
Enter the MySQL root password that you created during installation.
Create a new database using the following command:
CREATE DATABASE easyappointments;
Create a new MySQL user and grant it all privileges for the Easy!Appointments database using the following command:
GRANT ALL PRIVILEGES ON easyappointments.* TO 'easyappointmentsuser'@'localhost' IDENTIFIED BY 'password';
Replace 'password' with a strong password.
Flush the privileges with the following command:
FLUSH PRIVILEGES;
Exit the MySQL console using the following command:
exit
Navigate to the /var/www/easyappointments directory and rename the config-sample.php file to config.php:
cd /var/www/easyappointments
sudo mv config-sample.php config.php
Edit the config.php file:
sudo nano config.php
In the file, change the values of the following lines:
define('DB_HOST', 'localhost');
define('DB_NAME', 'easyappointments');
define('DB_USER', 'easyappointmentsuser');
define('DB_PASS', 'password');
Replace 'password' with the password you created for the easyappointmentsuser.
Save and close the file.
Restart the Apache server for the changes to take effect:
sudo systemctl restart apache2
Open a web browser and navigate to http://your_domain_name/ (replace your_domain_name with your actual domain name).
You will be redirected to the Easy!Appointments installation wizard. Follow the wizard steps to complete the installation.
Congratulations! You have successfully installed Easy!Appointments on POP! OS Latest.
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!
