Skip to content

DawOS CLI

DawOS CLI

Broadband management, simplified. Remote CLI for DawOS Agent.

  • Quick Start

    Get up and running in under 2 minutes.

    Quick Start

  • Installation

    Install on Linux, macOS, or Windows.

    Installation

  • Commands

    Full reference for all 31 command groups + 6 top-level commands.

    Command Reference

  • Configuration

    Multi-profile setup for managing multiple BNG nodes.

    Configuration

What is DawOS CLI?

DawOS CLI is a command-line tool for managing PPPoE/BNG routers powered by accel-ppp through the DawOS Agent REST API.

Features

  • Full BNG Control — Sessions, firewall, routing, NAT, traffic shaping, and more
  • Live Dashboard — Real-time monitoring with dawos top
  • Multi-Profile — Manage multiple BNG nodes from one CLI
  • Automation Ready — --json and --format csv|yaml output for scripting
  • Interactive Shell — dawos shell REPL with tab completion
  • Self-Diagnostics — dawos doctor checks environment, connectivity, config
  • Self-Updating — Built-in update notifications and dawos update
  • Secure — API key authentication with profile export/import

Quick Example

# Add your BNG node
dawos profile add prod --url http://192.168.1.1:8470 --key YOUR_API_KEY

# Check status
dawos status

# View active sessions
dawos session list

# Live dashboard
dawos top

Requirements

Install

pip install dawos-cli

See Installation for more options (pipx, Homebrew, installer script).