satnogs-network/README.md

# Fork
This is a fork of the SatNOGS Network. It is available here:

* http://network.satnogs.spacecruft.org


# Install SatNOGS-DB
Set up for Debian Buster.

## Install docs

* https://docs.satnogs.org/projects/satnogs-network/en/stable/installation-virtualenv.html

## Install dependencies
```
apt update
apt install -t buster-backports apache2
apt install python3 virtualenvwrapper python3-pip git python3-certbot-apache npm default-libmysqlclient-dev libmariadbclient-dev libjpeg-dev sass redis-server
# Set up SSL
certbot
```

## Install Virtual Environment
Set up `virtualenvs`  (like this? Not in docs).

```
mkdir $HOME/.virtualenvs
echo "export WORKON_HOME=$HOME/.virtualenvs" >> $HOME/.bashrc
echo "source /usr/share/virtualenvwrapper/virtualenvwrapper.sh" >> $HOME/.bashrc
source ~/.bashrc
# Make sure it looks ok:
workon
```

## Install satnogs-network from git
```
git clone https://spacecruft.org/spacecruft/satnogs-network.git
cd satnogs-network
mkvirtualenv --python=/usr/bin/python3 satnogs-network -a .
cp env-dist .env
# Set values in .env thusly:
ALLOWED_HOSTS=network.satnogs.spacecruft.org
# and SECRET_KEY to a long random string
vim .env
npm install
./node_modules/.bin/gulp
```

## Run satnogs-network
Note, you may have to change the listen IP and port:

```
vim bin/djangoctl.sh
# Change:
exec "$MANAGE_CMD" runserver 0.0.0.0:8000
# To:
exec "$MANAGE_CMD" runserver 127.0.0.1:8100
```

Then start the thing:
```
cd satnogs-network # if you aren't there already
workon satnogs-network
./bin/djangoctl.sh develop .
```

## Populate satnogs-network
While `./bin/djangoctl.sh develop .` is running above, in another terminal
run:

```
workon satnogs-network
./bin/djangoctl.sh initialize
```

# Upstream
See below for upstream README.

# SatNOGS Network

SatNOGS Network is a web application, implementing a global scheduling and monitoring network for ground station operations.

It features multiple observers to multiple intrumentation functionality and manages observation jobs and results.

## Contribute

Check out the [documentation](https://docs.satnogs.org/projects/satnogs-network/en/stable/) on how to setup a local development instance.

The main repository lives on [Gitlab](https://gitlab.com/librespacefoundation/satnogs/satnogs-network) and all Merge Request should happen there.

## Join

[![irc](https://img.shields.io/badge/Matrix-%23satnogs:matrix.org-blue.svg)](https://riot.im/app/#/room/#satnogs:matrix.org)
[![irc](https://img.shields.io/badge/IRC-%23satnogs%20on%20freenode-blue.svg)](https://webchat.freenode.net/?channels=satnogs)
[![irc](https://img.shields.io/badge/forum-discourse-blue.svg)](https://community.libre.space/c/satnogs)

## Current Development

[![kanban](https://img.shields.io/badge/kanban-board-lightgray.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-network/boards/345495)
[![build](https://gitlab.com/librespacefoundation/satnogs/satnogs-network/badges/dev/build.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-network/commits/dev)
[![coverage](https://gitlab.com/librespacefoundation/satnogs/satnogs-network/badges/dev/coverage.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-network/commits/dev)

## License

[![license](https://img.shields.io/badge/license-AGPL%203.0-6672D8.svg)](LICENSE)
[![Libre Space Foundation](https://img.shields.io/badge/%C2%A9%202014--2018-Libre%20Space%20Foundation-6672D8.svg)](https://librespacefoundation.org/)