GeoStream AI

GEOSTREAM AI / INSTALLATION GUIDE

Run GeoStream.
Keep data persistent.

Install the Panel and API images with Docker, keep data in a persistent directory outside the containers, and complete the initial setup in the Panel.

DockerPersistent dataSQLitePostgreSQL

DOCKER INSTALLATION

Images first.
A secure foundation next.

The Panel and API must use the same GeoStream version. Keeping the data directory on the host preserves configuration, database files, and logs when containers are recreated.

01 / VERSION

Choose a Docker Hub tag

Choose a compatible tag for the Panel and API. Use latest for the newest release, or use the same pinned version number for both images.

# Docker Hub tag pages
otekyazilim/geostream-panel
otekyazilim/geostream-api
02 / PULL

Pull the images

Pull the Panel and API images on the server. For a pinned version, replace latest below with the selected tag.

docker pull otekyazilim/geostream-panel:latest
docker pull otekyazilim/geostream-api:latest
03 / VOLUME

Mount the persistent data directory

Create a writable directory on the host and mount it at /data in both containers. GeoStream configuration, the SQLite database, and logs are stored there.

# example volume mapping
/geostream_product/data:/data
04 / SET UP

Open the Panel and select the data source

The Panel opens its setup screen on first launch. Choose SQLite for individual use, a quick start, or a small single-server deployment; it creates geostream.db in the data directory and needs no additional database server. Choose PostgreSQL for centralized, multi-user, or enterprise deployments. An empty database is initialized with the GeoStream schema; an existing database must already contain the complete schema.

# PostgreSQL connection example
Host=...;Port=5432;Database=...;
Username=...;Password=...
05 / SIGN IN

Sign in and secure access

Sign in with the initial administrator account admin@geostream.local / admin, then change the default password immediately.

admin@geostream.local
admin
06 / KEY

Request GeoStreamKey

After the installation is complete, email OTEK Yazılım to request the GeoStreamKey for your deployment. When you receive the key, open the Web Panel and go to Settings → About → GeoStreamKey. Enter the key and select Save. Then open Settings and select Refresh Caches to apply the change across the running services. Saving the key already publishes a cache-refresh notification; Refresh Caches lets you send the refresh request manually as well.

Email: geostream@otekyazilim.com

WINDOWS & LINUX INSTALLATION

Request the package.
Complete the same setup.

For Windows and Linux installations, request the installation package first. The data directory, initial Panel configuration, and access steps follow the same GeoStream setup flow.

WINDOWS INSTALLATION

Windows

  1. 01 / REQUESTEmail geostream@otekyazilim.com to request the GeoStream installation package.
  2. 02 / INSTALLInstall the delivered Windows package and start the GeoStream Panel and API.
  3. 03 / DATACreate a writable persistent data directory, for example C:\GeoStream\data. In an elevated PowerShell session, set the machine environment variable:

    [Environment]::SetEnvironmentVariable("GEOSTREAM_DATA_DIR", "C:\GeoStream\data", "Machine")
  4. 04 / SET UPOpen the Panel setup screen. Choose SQLite for individual use, a quick start, or a small single-server deployment. Choose PostgreSQL for centralized, multi-user, or enterprise deployments.
  5. 05 / SIGN INSign in with admin@geostream.local / admin, then change the default password.
  6. 06 / KEYEmail geostream@otekyazilim.com to request your GeoStreamKey. After receiving it, go to Settings → About → GeoStreamKey, enter it, and select Save. Then select Settings → Refresh Caches.
LINUX INSTALLATION

Linux

  1. 01 / REQUESTEmail geostream@otekyazilim.com to request the GeoStream installation package.
  2. 02 / INSTALLInstall the delivered Linux package and start the GeoStream Panel and API.
  3. 03 / DATACreate a writable persistent data directory, for example /geostream_product/data. Set the environment variable before starting the Panel and API:

    export GEOSTREAM_DATA_DIR=/geostream_product/data
  4. 04 / SET UPOpen the Panel setup screen. Choose SQLite for individual use, a quick start, or a small single-server deployment. Choose PostgreSQL for centralized, multi-user, or enterprise deployments.
  5. 05 / SIGN INSign in with admin@geostream.local / admin, then change the default password.
  6. 06 / KEYEmail geostream@otekyazilim.com to request your GeoStreamKey. After receiving it, go to Settings → About → GeoStreamKey, enter it, and select Save. Then select Settings → Refresh Caches.

OPTIONAL AUTHENTICATION

Configure Google sign-in.

Google sign-in is optional. After the initial data-source setup creates geostream.config.json, add your Google OAuth client credentials under Authentication → Google.

Both values are required to show the Google sign-in option. Restart the Panel after editing the file.

{
  "Driver": "NATIVE",
  "ConString": "SQLITE:[datadir]/geostream.db",
  "Authentication": {
    "Google": {
      "ClientId": "YOUR_GOOGLE_CLIENT_ID",
      "ClientSecret": "YOUR_GOOGLE_CLIENT_SECRET"
    }
  }
}

WE ARE HERE TO HELP

Questions, requests,
or ideas?

For installation support, feature requests, product feedback, or any GeoStream question, email our team. We will get back to you as soon as possible.

geostream@otekyazilim.com