Reference

Troubleshooting

Common deployment and machine issues.

Local build contexts are rejected

Nethera does not upload source directories for MVP.

nethera.yml

services:
  web:
    build: .

Build and push an image to a registry, then reference it with image:.

This is not supported:

nethera.yml

services:
  web:
    volumes:
      - ./data:/data

Use an absolute path on the target machine:

nethera.yml

services:
  web:
    volumes:
      - /mnt/nethera/app-data:/data

Use app-scoped secrets instead:

bash

$neth secrets set API_KEY

Then list the secret under services.<service>.nethera.secrets.

The agent initiates pairing after installation. Follow the pairing prompt shown by the agent. Then check:

bash

$sudo systemctl status nethera-agent
$sudo journalctl -u nethera-agent -n 100 --no-pager

Check nethera.auth.