Skip to content

GNO-SYS/Haystac

Repository files navigation

Haystac

Alt text

Overview

Haystac is an ASP.NET Spatio-Temporal Asset Catalog (STAC) solution that offers both a web API and client CLI for interacting with your STAC entities.

The goal of this project is offer an open-source, secured, and configurable STAC solution that is easily extendable to any consumer's use case.

Hay Stack comes in two versions: HaySTAC (this repo) and HaySTAC enterprise. HaySTAC Enterprise is a commercial version that includes advanced features such as security, user management, cloud integration, enhanced metadata and search, a graphic browser, auto ingest, etc.

The project is heavily inspired by the Clean Architecture project template developed by Jason Taylor et al.

Technologies

Getting Started

Docker Compose

Haystac provides a docker-compose file that will configure & stand-up a test API container alongside a PostGIS container that consumers can use to validate usage as if deployed into a cloud environment.

In order to support serving over HTTPS - you'll need to enter the following commands:

dotnet dev-certs https -ep "$env:USERPROFILE\.aspnet\https\haystac.pfx"  -p haystac
dotnet dev-certs https --trust

In the preceding commands, you can change the names of the certificate and the password - but you'll have to update the docker-compose file here:

ASPNETCORE_Kestrel__Certificates__Default__Password: haystac
ASPNETCORE_Kestrel__Certificates__Default__Path: /https/haystac.pfx

Now, execute the following

docker-compose up -d

This will then build the images, and server the API over:

And then to tear things down, execute:

docker-compose down

See: Hosting ASP.NET Core images with Docker Compose over HTTPS