Cloudlog is an open source web application designed for amateur radio operators to log their contacts. This tutorial outlines the steps required to install Cloudlog on macOS.
Before installing Cloudlog, you will need to ensure that the following software is installed on your macOS device:
If you do not have these installed, you can follow this tutorial to install them.
The first step is to download Cloudlog from the official website. Once downloaded, extract the files into the /Library/WebServer/Documents
directory.
Next, you will need to create a MySQL database for Cloudlog. Open Terminal and enter the following command:
mysql -u root -p
You will be prompted for your MySQL root password. Enter it to proceed.
CREATE DATABASE cloudlog;
GRANT ALL PRIVILEGES ON cloudlog.* TO 'cloudlog'@'localhost' IDENTIFIED BY 'yourpassword';
FLUSH PRIVILEGES;
The above commands create a database named "cloudlog" and a user named "cloudlog", with the password "yourpassword", with all privileges to the "cloudlog" database.
Copy the config.php.default
file, located in /Library/WebServer/Documents/cloudlog/application/config/
, to a new file named config.php
.
cd /Library/WebServer/Documents/cloudlog/application/config/
cp config.php.default config.php
Open the config.php
file and modify the following lines to reflect the MySQL database credentials that you created previously:
$db['default']['hostname'] = 'localhost';
$db['default']['username'] = 'cloudlog';
$db['default']['password'] = 'yourpassword';
$db['default']['database'] = 'cloudlog';
In order for Cloudlog to function properly, the web server must have read/write access to certain directories. Use the following commands to grant these permissions:
cd /Library/WebServer/Documents/cloudlog
chmod -R 777 backup/
chmod -R 777 application/logs/
Now that Cloudlog is installed and configured, you need to create a virtual host to ensure that it is accessible via a web browser.
Open the Apache configuration file by running the following command in Terminal:
sudo nano /etc/apache2/httpd.conf
Scroll down and uncomment the following line to enable virtual hosts:
#Include /private/etc/apache2/extra/httpd-vhosts.conf
Save and close the file by pressing Ctrl + X
, then Y
and Enter
.
Next, open the virtual hosts configuration file by running the following command:
sudo nano /etc/apache2/extra/httpd-vhosts.conf
Add the following code to create a virtual host:
<VirtualHost *:80>
ServerAdmin info@example.com
DocumentRoot "/Library/WebServer/Documents/cloudlog"
ServerName cloudlog.local
ErrorLog "/private/var/log/apache2/cloudlog-error_log"
CustomLog "/private/var/log/apache2/cloudlog-access_log" common
</VirtualHost>
Save and close the file by pressing Ctrl + X
, then Y
and Enter
.
Finally, restart Apache for the changes to take effect:
sudo apachectl restart
Open a web browser and navigate to the following URL:
http://cloudlog.local
You should see the Cloudlog login page. Enter your username and password to access the application.
Congratulations! You have successfully installed Cloudlog on macOS.
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!
Alternatively, for the best virtual desktop, try Shells!