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