missing or incomplete nats configuration.

[NiklasRosenstein]

I'm trying to run OpenCloud in my Homelab on K3s. I've tried the Helm chart but unfortunately it still has a few shortcomings, so instead I tried to build my own small deployment based on the Docker compose example. I'm a bit stuck now and not sure how to proceed. I've taken quite a bit of are to use the relevant bits of configuration from the example, but I must be missing something.

My collaboration container logs:

{"level":"fatal","service":"collaboration","error":"Failed to connect to NATS Server: nats: no servers available for connection","time":"2025-06-20T23:24:25Z","line":"github.com/opencloud-eu/opencloud/pkg/registry/register.go:23","message":"Registration error for external service eu.opencloud.api.collaboration.CollaboraOnline"}

Checking the opencloud container logs, it seems nats is starting fine:

{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"Starting nats-server"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Version:  2.11.4"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Git:      [94b79a0]"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Cluster:  opencloud-cluster"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Name:     NAC54DSJNVXKIPAIHXQKIR3D6IOVY7C5PWQBJWBBOPK5J2BQJ2PEBJSU"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Node:     24dSivpF"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  ID:       NAC54DSJNVXKIPAIHXQKIR3D6IOVY7C5PWQBJWBBOPK5J2BQJ2PEBJSU"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"Starting JetStream"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"    _ ___ _____ ___ _____ ___ ___   _   __  __"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":" _ | | __|_   _/ __|_   _| _ \\ __| /_\\ |  \\/  |"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"| || | _|  | | \\__ \\ | | |   / _| / _ \\| |\\/| |"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":" \\__/|___| |_| |___/ |_| |_|_\\___/_/ \\_\\_|  |_|"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"         https://docs.nats.io/jetstream"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"---------------- JETSTREAM ----------------"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Max Memory:      22.95 GB"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Max Storage:     3.44 TB"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Store Directory: \"/var/lib/opencloud/nats/jetstream\""}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  API Level:       1"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"-------------------------------------------"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Starting restore for stream '$G > KV_activitylog'"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Restored 57 messages for stream '$G > KV_activitylog' in 20ms"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Starting restore for stream '$G > KV_eventhistory'"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Restored 277 messages for stream '$G > KV_eventhistory' in 20ms"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Starting restore for stream '$G > KV_ids-storage-users'"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Restored 64 messages for stream '$G > KV_ids-storage-users' in 16ms"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Starting restore for stream '$G > KV_postprocessing'"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Restored 33 messages for stream '$G > KV_postprocessing' in 16ms"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Starting restore for stream '$G > KV_proxy'"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Restored 1 messages for stream '$G > KV_proxy' in 16ms"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Starting restore for stream '$G > main-queue'"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Restored 277 messages for stream '$G > main-queue' in 15ms"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"  Recovering 13 consumers for stream - '$G > main-queue'"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"Listening for client connections on 0.0.0.0:9233"}
{"level":"info","service":"nats","time":"2025-06-20T23:12:43Z","line":"github.com/opencloud-eu/opencloud/services/nats/pkg/logging/nats.go:21","message":"Server is ready"}

But then the storage-system and ocm services complain about nats, which seems connected to the issue with the companion container:

{"level":"warn","service":"storage-system","pkg":"rhttp","time":"2025-06-20T23:12:44Z","line":"github.com/opencloud-eu/reva/v2@v2.33.1/internal/http/services/dataprovider/dataprovider.go:84","message":"missing or incomplete nats configuration. Events will not be published."}
{"level":"warn","service":"ocm","pkg":"rhttp","time":"2025-06-20T23:12:44Z","line":"github.com/opencloud-eu/reva/v2@v2.33.1/internal/http/services/dataprovider/dataprovider.go:84","message":"missing or incomplete nats configuration. Events will not be published."}

The relevant env vars in the opencloud container are (let me know if I'm missing some):

        MICRO_REGISTRY_ADDRESS: "127.0.0.1:9233",
        NATS_NATS_HOST: "0.0.0.0",
        NATS_NATS_PORT: "9233",

The 9233 is configured in the Service for opencloud as well which the companion uses to communicate with nats (MICRO_REGISTRY_ADDRESS: "opencloud:9233" in the companion container).

I'd much appreciate a hint of what could be configured wrong! Thanks

[NiklasRosenstein]

My issue was that I had a misconfiguration in the Pod (missing a containerPort for nats) such that the Service had no endpoint for the NATS port. Fixed!

[flightcode]

Can you please elaborate? I'm having the same error and I don't understand what misconfiguration you're referring to

[NiklasRosenstein]

My Kubernetes Service was configured to forward traffic to a named port nats, but I did not define that named port in the Pod. This is not an issue when you're not using a named port, since the ports on the Pod containers don't need to be declared to be able to connect to them.