Configuration

OWS has two configuration files, both in /opt/osop/ows/config/:

File

What it sets

ows-host.conf

Settings for this computer: the port Winston clients connect to and where your SDS archive is.

ows.conf

OWS itself: the SeedLink server, the archive on/off switch, logging.

The installer creates both with working defaults and never overwrites them on upgrades. After editing either file, apply the change with:

sudo ows restart

Typical setups

Setup

ows.conf

ows-host.conf

SeisComP on the same computer (SeedLink on its default port 18000, archive written by slarchive)

sources.seedlink.host = host.docker.internal

sources.seedlink.port = 18000

ARCHIVE_DIR= the SeisComP archive, for example /home/sysop/seiscomp/var/lib/archive

SeedLink server on another computer

sources.seedlink.host = 192.0.2.10 (its address or host name)

sources.seedlink.port = its SeedLink port

ARCHIVE_DIR= a local copy of the archive, or a network mount

Archive only, no live data

sources.seedlink = false

ARCHIVE_DIR= your archive

Live data only, no archive

sources.sds = false

consider a longer sources.seedlink.ring_size

(unchanged)

How live data and the archive work together

  • Live data. OWS receives data for every station the SeedLink server offers (see New stations on the SeedLink server for stations added later). It keeps the most recent part in memory: by default the last 5 minutes of every channel (sources.seedlink.ring_size).

  • Archive. Everything older comes from the SDS archive. OWS reads it as needed and looks for new channels in it every 30 seconds.

  • Together. A request is answered from both sources. A Swarm helicorder showing the last day therefore needs the archive for everything except the last few minutes. If the archive is the one your SeisComP slarchive writes, it is always up to date.

ows-host.conf

This file uses shell syntax (NAME=value, no spaces around =).

LISTEN_PORT

Default: 16032

The TCP port on this computer where Winston clients (Swarm, Earthworm, ObsPy) connect. 16032 is the usual Winston port. Change it if another program already uses 16032. Clients connect to OWS on this port, on any of this computer’s network addresses.

ARCHIVE_DIR

Default: /opt/osop/ows/archive

The root folder of your SDS archive on this computer. OWS only reads it; it never writes to or deletes from it. The folder must use the SDS layout (see SDS archive layout).

ows.conf

Each line is key = value. Lines starting with # are comments. A few rules:

  • Write true and false in lower case. Anything else, including True, counts as false.

  • Values can’t contain spaces; spaces are removed.

  • If a key appears twice, the first one counts.

  • The file uses paths inside the OWS container (/opt/log, /opt/archive, /opt/cache). Leave them as they are; to change where the archive is on this computer, set ARCHIVE_DIR in ows-host.conf.

Archive (SDS)

sources.sds

Default in the installed file: true

true to serve data from the SDS archive set by ARCHIVE_DIR. false to serve live data only.

sources.sds.dir

Leave it at /opt/archive. OWS always reads the archive from there; the folder on this computer is set by ARCHIVE_DIR in ows-host.conf.

Logging

logging.file

Default in the installed file: ows.log

The log file’s name. It is written to /opt/osop/ows/log/ on this computer. Without this key, OWS writes no log file.

logging.debug

Default in the installed file: false

true for detailed logging, for example when OSOP support asks for it. Debug logs grow quickly; set it back to false afterwards.

logging.stderr_out

Default in the installed file: true

true to also send the log to the console, which sudo ows logs shows.

logging.dir

Leave it at /opt/log. OWS always writes its log there, which is /opt/osop/ows/log/ on this computer.

Other keys

listen.host

Leave it at 0.0.0.0. OWS always accepts connections on all of this computer’s network addresses.

listen.port

Leave it at 16032. To change the port clients connect to, set LISTEN_PORT in ows-host.conf instead.

cache.dir

Leave it at /opt/cache. OWS always keeps its station lists there (/opt/osop/ows/cache/ on this computer; see New stations on the SeedLink server).

cache.hours

Default in the installed file: 24

Kept for compatibility. It has no effect in this version; leave it as it is.

cache.segments

Default in the installed file: 10

Kept for compatibility. It has no effect in this version; leave it as it is.

license.file

Not in the installed file. Leave it out: OWS then reads the license from /opt/osop/license/ows.key, the location sudo ows check checks (License).

SDS archive layout

OWS reads miniSEED files in the SDS (SeisComP Data Structure) layout, the one SeisComP’s slarchive and scart write:

ARCHIVE_DIR/YEAR/NET/STA/CHAN.D/NET.STA.LOC.CHAN.D.YEAR.DAY

for example
/home/sysop/seiscomp/var/lib/archive/2026/AM/R0CA2/EHZ.D/AM.R0CA2.00.EHZ.D.2026.311

OWS skips other files and folders inside the archive, so the archive folder may also contain other things.