n8acl/ospotalog repository overview

⁠phpContestLogger - Ohio State Parks on the Air (OSPOTA)

The Ohio State Parks on the Air (OSPOTA) Amatuer Radio contest was conceived with three main goals in mind:

• To promote public awareness of amateur radio and Ohio’s beautiful state parks system;
• To contribute to the recognition that Ohio has a very diverse and wonderful ecology;
• To promote camaraderie within the ranks of Ohio’s Amateur Radio Operators

(From the OSPOTA website at http://ospota.org/⁠)

This is an annual contest held every year on the first Saturday of Septemeber after Labor Day.

⁠Description

While there are a number of logging options out there, this program was concieved as

• an OS agnostic software solution.
• lightweight and portable server based system

Many people like to bring thier own computer or tablet to log on during a contest like this and many Amatuer Radio groups don't have the means to provide computers for everyone to log on.

Since there are many different OS's for computers and tablets, creating a php/browser based application eliminates the "Oh I don't have Windows/Mac/Linux" problem.

This can be spun up on a regular server or laptop at the site or can be spun up on a Raspberry Pi for a small and power light system to be used as a server for the site.

⁠Getting Started

Since you are on Dockerhub, it can be assumed you are familiar with Docker and Docker Compose and already have them installed. If not, you will need to have those installed first.

If you would like to run this program on a regular webserver and MYSQL Database, please see https://github.com/n8acl/ospotalog⁠.

Next you will need to create a directory to hold the MySQL files to not loose data.

mkdir mysql_data

⁠Docker Compose

If you are going to run this on an x86_64 system, use the following for your docker-compose.yml file:

version: '3.3'
services:
    db:
      image: mysql
      command: --default-authentication-plugin=mysql_native_password
      restart: always
      volumes:
            - '/<path-to>/mysql_data:/var/lib/mysql'
      ports:
            - '3306:3306'
      environment:
        MYSQL_ROOT_PASSWORD: example
      container_name: mysql
      
    ospotalog:
        restart: always
        ports:
            - '8080:80'
        image: n8acl/ospotalog:latest
        container_name: ospotalog            

if you are going to run this on a Raspberry Pi, use the following for your docker-compose.yml:

version: '3.3'
services:
    db:
      image: yobasystems/alpine-mariadb:latest
      command: --default-authentication-plugin=mysql_native_password
      restart: always
      volumes:
            - '/<path-to>/mysql_data:/var/lib/mysql'
      ports:
            - '3306:3306'
      environment:
        MYSQL_ROOT_PASSWORD: example
        container_name: mysql
      
    ospotalog:
        restart: always
        ports:
            - '8080:80'
        image: n8acl/ospotalog:latest
        container_name: ospotalog

Make sure to change the following:

• < path-to > to the path of the mysql_data folder. For Example: /home/user/mysql_data
• MYSQL_ROOT_PASSWORD: make this a password you will remember. You will need this for the setup of the database for the system in a minute.

Save your docker-compose.yml file.

Now bring up the containers:

docker-compose up -d

Verify the containers are running:

docker container ls --all

⁠Starting the Program

Once you have verified the containers are running, you need to ccess the create script for the database. to do this go to:

ip-address:8080/create.php

IP Address can be the address of the server running the docker container or the local host.

Once that page comes up, it is asking for the root password you setup for the mysql docker container from your docker-compose.yml file. Enter the password in the form and hit submit.

Once the database has been created, the page will be redirected to the main logging page. Also from this point forward, you can access the program by going to

ip-address:8080

If you try to go to the main logging page before running the create script, you will get an error. So macke sure to run the create first.

⁠Contact Me

If you have questions, please feel free to reach out to me. You can reach me in one of the following ways:

• Twitter: @n8acl
• Telegram: @ravendos
• Mastodon: @[email protected]⁠
• E-mail: [email protected]⁠

If you reach out to me and have an error, please include what error you are getting and what you were doing. I may also ask you to send me certain files to look at. Otherwise just reach out to me :).

⁠Change Log

• 07/03/2021 - rebuilt container for MultiArch Support for ARM64 and AMD64

• 09/21/2020 - Fixes for some glaring errors

  • Added ability ot edit contact after logging in case of a mistake.
  • Fixed the frequency privledges to show properly for band, mode and license class
  • Re-added the ability to select entry class on the settings page.

• 08/30/2020 - Initial Release