@kubbisec/naus
v1.0.85
Published
KubbiSec Naus CI/CD Runner — install globally, run anywhere
Maintainers
Readme
@kubbisec/naus
Official KubbiSec Naus CLI - register runners, execute pipelines, and validate definitions against the KubbiSec control plane.
Naus connects your infrastructure to KubbiSec CI/CD: secure runner enrollment, remote job execution, and local pipeline workflows.
Features
- Runner lifecycle - register with a bootstrap token, start the agent, and report to your organization’s control plane.
- Pipelines - run YAML pipelines locally or integrate with hosted runs.
- Validation - catch pipeline errors before they hit the cluster.
- Native binaries - platform-specific executables via
optionalDependencies(nopostinstallscripts; compatible withnpm install --ignore-scripts).
Requirements
- Node.js 18 or newer (for the global install and launcher).
- Docker (or equivalent) when jobs use containerized steps - see your organization’s documentation.
Installation
npm install -g @kubbisec/nausQuick start
# Enroll a runner (replace URL with your KubbiSec API / enrollment endpoint)
naus register <bootstrap-token> --api https://your-api.example.com
# Start the runner process
naus start
# Run a pipeline file locally
naus run pipeline.yml
# Validate a pipeline without executing
naus validate pipeline.ymlRun naus --help for the full command tree and flags.
Supported platforms
The meta-package @kubbisec/naus pulls the correct native binary for your OS and CPU:
| OS | Architecture | npm package |
|---------|--------------|--------------------------------|
| Linux | x64 | @kubbisec/naus-linux-x64 |
| Linux | arm64 | @kubbisec/naus-linux-arm64 |
| macOS | arm64 | @kubbisec/naus-darwin-arm64 |
| Windows | x64 | @kubbisec/naus-win32-x64 |
You normally do not install the platform packages directly; install @kubbisec/naus globally.
Terms
Distributed as prebuilt binaries for use with the KubbiSec platform. Not open source. Use is subject to your agreement with KubbiSec.
Trademarks
KubbiSec and related marks are property of their respective owners. This package is distributed by KubbiSec for use with the KubbiSec platform.
