nethera

Guides

Migrating from docker-compose.yml

Convert an existing Compose file into a Nethera app without uploading local source directories.

If you already have docker-compose.yml or compose.yml, neth init can import it into nethera.yml.

bash
$neth init

When prompted, choose to import the Compose file. Nethera normalizes the file and writes nethera.yml.

What usually changes

Add a nethera: block to any service you want reachable from the internet:

nethera.yml
services:
web:
image: ghcr.io/acme/app:latest
nethera:
public: 3000
auth: login

Check local file references

Nethera does not upload arbitrary local project files for MVP.

Unsupported:

nethera.yml
services:
web:
build: .
env_file:
- .env
volumes:
- ./data:/data

Use:

  • pushed container images instead of build: .;
  • app-scoped secrets instead of env_file;
  • absolute target-machine paths or named Docker volumes for persistent data;
  • managed files for small text config files.

Deploy

After reviewing nethera.yml:

bash
$neth deploy