Requirements and info

Python: CPython 3.6+

Operating system: Linux

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

Git repository:


Consult the GitLab page on how to clone the repository.


Set your environmental variables:

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


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.


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:

$ ./ develop

To remove SatNOGS Network virtualenv:

$ ./ remove

Production install

For production installations, check Deploying Django.


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

$ ./bin/ run

and to bring Celery up:

$ ./bin/ run_celery