Important: Only accepting PRs on the "dev" branch.

Cloudlog is a self-hosted PHP application that allows you to log your amateur radio contacts anywhere. All you need is a web browser and active internet connection.

While Cloudlog as started by Peter Goodhall, 2M0SQL, although since has received a lot of community code contributions. If you would like to contribute to Cloudlog please see the Contributing section below.

Website: http://www.cloudlog.co.uk

Requirements

• Linux based Operating System
• Apache (Nginx should work)
• PHP Version 7.4 (PHP 8.2 works)
• MySQL (MySQL 5.7 or higher)

Notes

• If you want to log microwave QSOs you will need to use a 64bit operating system.
• We do not provide Docker support, however you are free to use it if you wish but we will not handle support.

Setup

Installation information can be found on the wiki.

Docker Development Environment

This guide provides instructions for setting up a local development environment using Docker and Docker Compose. Please note that this setup is not recommended for production use.

Prerequisites

Before you begin, you need to install Docker and Docker Compose. You can download them using the following links:

• Docker
• Docker Compose

Configuration

1. Copy the .env.sample file to .env:

   cp .env.sample .env
   

2. Open the .env file and update the values to match your setup. The values from the .env file will be used to populate the database connection details on the install page. You should not need to change these unless your setup requires different values.

   Note: Docker Compose creates a network for your application, and each service (container) in the Docker Compose file can reach each other via the service name. This is why the DB_HOST value in the .env file and on the install page should match the service name of the database in the docker-compose.yml file. For example, if the database service in docker-compose.yml is defined as db, then DB_HOST should be set as 'db'. This allows the application to communicate with the database service on its internal docker network.

Starting the Development Environment

To start the development environment, run the following command in your terminal:

docker-compose up

Running Cypress Tests Locally

Follow these steps to run the Cypress tests locally on your machine:

1. Clone the repository

   If you haven't already, clone the repository to your local machine

2. Setup .env file

   Copy the sample .env file and adjust it to your local environment:

   cd your-repo
   cp