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.
Docker Compose (recommended)
Change into the cloned repository directory:
$ cd <path/to/clone>
To run SatNOGS Network service:
$ ./satnogs.sh up
To stop SatNOGS Network service:
$ ./satnogs.sh down
To clean-up SatNOGS Network installation:
$ ./satnogs.sh clean
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