Cloudlog — Self-Hosted, Open-Source

Log your amateur radio contacts anywhere.

License: MIT. Built with: PHP, JavaScript, CSS, HTML, Shell, Hack, XSLT, Dockerfile. Website: https://magicbug.co.uk/cloudlog/. Source: https://github.com/magicbug/cloudlog.

Installation

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: ```bash 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: ```bash cd your-repo cp .env.sample .env ``` 3. **Build Docker services** Build and start the Docker services:

Why self-host Cloudlog

Self-hosting gives you three things SaaS can’t: data ownership (the files live on disks you control), cost predictability (a one-time setup vs. recurring per-seat fees that grow with your household or team), and longevity (open-source means the app keeps working even if the maintainers move on, since you can pin a working version). The trade-off is that you take on the operational work of running a server, applying updates, and handling backups.

What hardware do you need

Most self-hosted apps run comfortably on modest hardware — a Raspberry Pi 4, a mini PC, a NAS with Docker support, or a small VPS is usually enough for personal or family use. CPU and RAM requirements scale with how many simultaneous users or how much data you push through Cloudlog. Storage requirements depend on the kind of data you keep; check the README for guidance on data retention.

Where to go from here

Last verified: 2026-04-28