110 lines
2.2 KiB
Markdown
110 lines
2.2 KiB
Markdown
|
# SatNOGS DB Fork
|
||
|
This lesser fork is for exploring the SatNOGS DB.
|
||
|
|
||
|
* https://spacecruft.org/spacecruft/satnogs-db
|
||
|
|
||
|
|
||
|
# Install Dependencies
|
||
|
Using Debian Stable (Bullseye/11).
|
||
|
|
||
|
```
|
||
|
sudo apt install git libmariadb-dev mariadb-server npm python3-pip virtualenvwrapper
|
||
|
```
|
||
|
|
||
|
# Repo setup
|
||
|
I setup my `git` repo thusly.
|
||
|
|
||
|
```
|
||
|
git clone git@spacecruft.org:spacecruft/satnogs-db.git
|
||
|
cd satnogs-db
|
||
|
git remote add upstream https://gitlab.com/librespacefoundation/satnogs/satnogs-db.git
|
||
|
git fetch upstream
|
||
|
git checkout remotes/upstream/master
|
||
|
git branch spacecruft
|
||
|
git checkout spacecruft
|
||
|
git push --set-upstream origin spacecruft
|
||
|
# set to default branch in gitea
|
||
|
```
|
||
|
|
||
|
|
||
|
# Setup
|
||
|
Set up the environment.
|
||
|
|
||
|
To use `virtualenvwrapper`, you need to add it to the PATH.
|
||
|
The easiest way is to just add this like to the end of
|
||
|
`~/.bashrc`.
|
||
|
|
||
|
```
|
||
|
source /usr/share/virtualenvwrapper/virtualenvwrapper.sh
|
||
|
```
|
||
|
|
||
|
Then log out and back in or just re-source the file.
|
||
|
This will enable the `mkvirtualenv` and `workon` commands.
|
||
|
|
||
|
|
||
|
```
|
||
|
cd satnogs-db
|
||
|
mkvirtualenv satnogs-db -a .
|
||
|
pip install --upgrade pip
|
||
|
cp env-dist .env
|
||
|
```
|
||
|
|
||
|
Then edit the `.env` file to add `ALLOWED_HOSTS` for remote acccess
|
||
|
on LAN. Use IP address of *server*.
|
||
|
|
||
|
```
|
||
|
ALLOWED_HOSTS='192.168.1.100'
|
||
|
```
|
||
|
|
||
|
|
||
|
# Front End Dependencies
|
||
|
Install front end.
|
||
|
Each command takes one minute or so to run.
|
||
|
|
||
|
```
|
||
|
npm install
|
||
|
./node_modules/.bin/gulp
|
||
|
```
|
||
|
|
||
|
|
||
|
# Populate Database
|
||
|
Run thusly:
|
||
|
|
||
|
```
|
||
|
workon satnogs-db # if you aren't already in the environment
|
||
|
./bin/djangoctl.sh develop .
|
||
|
```
|
||
|
|
||
|
Set up database in another terminal, when above command is ready
|
||
|
and listening on port 8000:
|
||
|
|
||
|
```
|
||
|
cd satnogs-db
|
||
|
workon satnogs-db
|
||
|
./bin/djangoctl.sh initialize
|
||
|
```
|
||
|
|
||
|
# Access
|
||
|
May need to open firewall on server, `TCP/8000`.
|
||
|
|
||
|
|
||
|
# Use
|
||
|
In web browser go to server IP, port 8000.
|
||
|
|
||
|
http://192.168.1.1:8000/
|
||
|
|
||
|
Log in with super user created above when initializing.
|
||
|
It will verify email address. Look in the output of the
|
||
|
terminal running the django command above for the URL
|
||
|
to validate the email address (assuming no email is
|
||
|
actually used).
|
||
|
|
||
|
|
||
|
# Upstream
|
||
|
See upstream `README-upstream.md`.
|
||
|
|
||
|
* https://db.satnogs.org/
|
||
|
* https://gitlab.com/librespacefoundation/satnogs/satnogs-db.git
|
||
|
* https://docs.satnogs.org/projects/satnogs-db/en/stable/
|
||
|
|