1
0
Fork 0
satnogs-db/README.md

100 lines
3.1 KiB
Markdown

# 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/)