Installation

Requirements and info

Python: CPython 3.6+

Operating system: Linux

Prerequisites: docker-compose (recommended) or virtualenv, npm.

Git repository: https://gitlab.com/librespacefoundation/satnogs/satnogs-network.git

Clone

Consult the GitLab page on how to clone the repository.

Configuration

Set your environmental variables:

$ cp env-dist .env
$ ${EDITOR} .env

Installation

Quick install

The recommended quick install method is to use Docker Compose. This method will start separate containers for Django runserver, Celery, MariaDB and Redis.

The Virtualenv quick install method lacks a task queue, uses SQLite as a database and memcached for caching. It is only recommended for frontend development.

Virtualenv

This installation method is recommended only for frontend development purposeses.

Change into cloned repository directory:

$ cd <path/to/clone>

To run SatNOGS Network in a virtualenv:

$ ./satnogs.sh develop

To remove SatNOGS Network virtualenv:

$ ./satnogs.sh remove

Production install

For production installations, check Deploying Django.

Gunicorn

If gunicorn is used as the WSGI server then to start the application use:

$ ./bin/djangoctl.sh run

and to bring Celery up:

$ ./bin/djangoctl.sh run_celery