satnogs-db/README.md

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

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

# Install SatNOGS-DB
Set up for Debian Buster.

## Install docs

* https://docs.satnogs.org/projects/satnogs-db/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 libmariadbclient-dev
# 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-db from git
```
git clone https://spacecruft.org/spacecruft/satnogs-db.git
cd satnogs-db
mkvirtualenv --python=/usr/bin/python3 satnogs-db -a .
cp env-dist .env
vim .env
npm install
./node_modules/.bin/gulp
```

## Run satnogs-db
```
cd satnogs-db # if you aren't there already
workon satnogs-db
./bin/djangoctl.sh develop .
```

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

```
./bin/djangoctl.sh initialize
```

This will ask you a few questions, including asking for username/password.
Then create an `ssh` tunnel to the server, and log in here:

* http://localhost:8000

It will then say it is mailing a link to you to verify account, but
email isn't set up yet. So Go back to where you ran
`./bin/djangoctl.sh initialize` and you'll see in the log the link
to go to to verify your email address. Go there, then you can log in
as the superuser you created above.

# Upstream
See below for upstream README.

# SatNOGS DB

SatNOGS DB is a transmitter suggestions and crowd-sourcing app.

## Contribute

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

The main repository lives on [Gitlab](https://gitlab.com/librespacefoundation/satnogs/satnogs-db).

## Join

[![matrix](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)
[![forum](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-db/boards/345706)
[![build](https://gitlab.com/librespacefoundation/satnogs/satnogs-db/badges/master/build.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-db/commits/master)
[![coverage](https://gitlab.com/librespacefoundation/satnogs/satnogs-db/badges/master/coverage.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-db/commits/master)

## 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--2019-Libre%20Space%20Foundation-6672D8.svg)](https://librespacefoundation.org/)