# njord

**Repository Path**: openGPL/njord

## Basic Information

- **Project Name**: njord
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-09
- **Last Updated**: 2025-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Njord 

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

## Status: This project is still very much a WORK IN PROGRESS.
Live Demo: https://openenc.com

<p>
    <img alt="Njord" src="./chart_server_fe/src/njord.jpg" width=500 >
    <img alt="Screenshot" src="./screenshot.png" width=500 >
</p>

### Marine Electronic Navigational Chart (ENC) Server

Njord consumes S-57 IHO transfer standard for digital hydrographic data. S-57 format chart data is published by 
hydrographic offices such as NOAA. https://www.charts.noaa.gov/ENCs/ENCs.shtml 

Njord displays ENC charts but does **NOT** strictly follow the IHO S-52 specifications for chart content and display.

S-52 display and S-57 data standards can be found here: https://iho.int/en/standards-and-specifications

----------

# Development System Requirements

* OpenJDK 17
* Gdal 3.6.2 **with Java bindings**
  * Note: Homebrew Gdal does not come with Java bindings and the osgeo tap is broken. 
          See [docs/gdal/README.md](docs/gdal/README.md) for building gdal from source with java via `brew`.
* PostGIS 13
  * See [chart_server_db/README.md](chart_server_db/README.md) for running PostGIS in a container for development. 

----------

# Local Development Quick Start

Bring up database
```shell
cd chart_server_db
docker-compose up
```

Bring up api
```shell
./gradlew :chart_server:run
```

Bring up front end with hot-reload
```shell
./gradlew :web:jsRun --continuous
```

----------

## Prod Dry run with install dist

```shell
export JAVA_OPTS="-Dcharts.webStaticContent=$HOME/source/njord/web/build/dist/js/productionExecutable -Djava.library.path=/opt/gdal/jni"
export CHART_SERVER_OPTS="-Dcharts.adminUser=test"
./gradlew :chart_server:installDist
./gradlew :web:jsBrowserDistribution
./chart_server/build/install/chart_server/bin/chart_server
```

----------

# Docs

[System Design Notes](docs/DESIGN.md)


# Install on Raspberry Pi

```shell
sudo apt install ./njord<version>.deb
sudo apt install ./gdal_3.10.0-1_arm64.deb
sudo systemctl enable postgresql.service
sudo bash -c "echo \"listen_addresses = 'localhost'\" >> /etc/postgresql/15/main/postgresql.conf"
sudo systemctl restart postgresql.service
sudo /opt/chart_server/njord_setup.sh
```