Start your first native-process project

Native projects can use uv, npm, pnpm, Make, or another explicit executable. Envarium does not require Docker for this path.

1. Review discovery

envarium project add /absolute/path/to/native-project
envarium manifest explain <project>

Confirm the executable, argument array, working directory, environment references, dependency order, expected ports, and health checks. Shell syntax is rejected unless the manifest explicitly enables it and surfaces the risk.

2. Preview and start

envarium plan start <project>
envarium start <project>
envarium status <project>

Success is a durable run with a process-identity fingerprint and a running or healthy project state. A stored PID alone is never sufficient evidence.

3. Read output and stop

envarium logs <project> --tail 50
envarium stop <project>
envarium status <project>

Envarium captures stdout and stderr separately, sends graceful termination to the process group or Job Object, and escalates only after the configured timeout. Success ends with no managed child process left behind.