snstac / cotproxyweb

Web Admin & API for COT Proxy

COTProxyWeb

COTProxy Web Administration

COTProxyWeb is a web-baesd front-end for the COTProxy program. COTProxyWeb supports creation, replacement, updating and deletion (CRUD) of COTproxy Objects & Transforms.

Concept of Operations CONOPS:

Support This Project

Help: Email [email protected] or Signal/WhatsApp: [phone]

This project has been developed for the Disaster Response, Public Safety and Frontline Healthcare community. All contributions further project development and ensure ongoing support.

Installation

COTProxyWeb should be installed from source:

$ git clone https://github.com/ampledata/cotproxyweb.git
$ cd cotproxyweb/
$ python3 -m pip install -r requirements.txt
$ python3 manage.py migrate
$ python3 manage.py createsuperuser \
  --username admin --email [email protected]

Running

COTProxyWeb should be started as a background sevice ('run forever', daemon, etc). Most modern Linux-based operating systems use the systemd System and Service Manager.

CentOS, Debian, Ubuntu, RaspberryOS, Raspbian

These instructions will create, enable and start a service on Linux.

1. Download the example cotproxy systemd service definition:

   $ sudo wget --output-document=/etc/systemd/system/cotproxyweb.service https://raw.githubusercontent.com/ampledata/cotproxyweb/main/cotproxyweb.service
   

2. Edit the COTProxyWeb service and change CHANGEME to the path to the directory where you downloaded cotproxyweb. (e.g. If you downloaded cotproxyweb to /home/pi/cotproxyweb, CHANGEME should be changed to /home/pi/cotproxyweb):

$ sudo nano /etc/systemd/system/cotproxyweb.service

3. Edit COTProxyWeb's settings.py and append the IP of the system where you're running COTProxyWeb to the HOSTS_ALLOWED list:

$ nano cotproxyweb/settings.py

4. Enable cotproxyweb systemd service:

   $ sudo systemctl daemon-reload
   $ sudo systemctl enable cotproxyweb
   $ sudo systemctl start cotproxyweb
   

5. You can view logs with: $ sudo journalctl -xef

Source

Github: https://github.com/ampledata/cotproxyweb

Author

Greg Albrecht W2GMD [email protected]

https://ampledata.org/

Copyright

COTProxyWeb is Copyright 2022 Greg Albrecht

License

COTProxyWeb is licensed under the Apache License, Version 2.0. See LICENSE for details.

cotproxyweb's Issues

Change default http listen port away from 8080 (dump1090)

If I'm running dump1090 and cotproxyweb on the same port, both will attempt to bind to localhost:8080, which is the default listen port for both programs.

Since changing dump1090 is a heavier lift, we'll bite the bullet and change cotproxyweb's default port away from 8080.

This will also require updating cotproxy.

Document method of modifying settings.py for local use (HOSTS_ALLOW)

For example, the default HOSTS_ALLOW is restrictive to only the development environments that me, the developer, are using. If someone spins up cotproxyweb on their own system, it may have a different IP, and thus remote access would require adding that IP to HOSTS_ALLOW.

Work Around:
Just edit cotproxyweb/settings.py in place.

NEW COTPROXYWEB PORT: 10415

NEW COTPROXYWEB PORT: 10415