Documentation

OWEN Pro Configuration Guide

Everything you need to install, configure, and run your OWEN agent team.

Quick startSetup wizardCommandsConfig reference
Quick start

Get up and running in minutes

Prerequisites: Docker (recommended) or a native runtime environment.

1. Download the installer
curl -fsSL https://fuwaandcompany.com/owenpro/install.sh | sh
2. Run the setup wizard
owen install
3. Start your agents
owen up
4. Check health
owen status
Setup wizard

The 6-step install wizard

Running owen install launches an interactive wizard. Here is what each step covers.

01
Identity
Enter a location name (e.g. "Chicago HQ") and the owner email address OWEN will use for notifications.
02
Product Selection
Choose which OWEN products to install. Dependencies are resolved automatically — selecting an add-on product will include its required base products.
03
Agent Review
Review every agent that will be deployed, including the role each one plays in your workflow.
04
Runtime Configuration
Choose Docker (recommended) or native mode, and set your preferred log level (debug, info, warn, error).
05
Generate Configuration
OWEN writes ~/.owen/config.yaml and ~/.owen/runtime/docker-compose.yaml based on your selections.
06
Platform Registration
Optional. Register your instance with the OWEN platform API to enable remote monitoring and updates.
File system

Directory structure

After running the wizard, OWEN creates the following in your home directory.

~/.owen/
  config.yaml                  # Main configuration
  runtime/
    docker-compose.yaml        # Generated compose file
  logs/
    <agent-id>/                # Per-agent log directories
  data/
    <agent-id>/                # Per-agent persistent data
Commands

Command reference

All commands are run from your terminal after installation.

owen installRun the interactive 6-step setup wizard
owen upStart all configured agents
owen downStop all running agents
owen statusShow instance info and agent health
owen logs <agent>Tail logs for a specific agent
owen configDisplay the current configuration
owen agentsBrowse the full agent catalog
owen versionPrint the installed CLI version
Config reference

config.yaml fields

Located at ~/.owen/config.yaml. Edit this file to change settings without re-running the wizard.

Run owen config to display the current values.

instance_idUnique identifier for this OWEN instance
location_nameHuman-readable name (e.g. "Chicago HQ")
owner_emailEmail address for notifications
products[].product_idWhich OWEN product is installed
products[].agent_idsActive agents for that product
runtime.modedocker or native
runtime.log_leveldebug, info, warn, or error
registration.registeredWhether registered with OWEN platform
registration.endpointPlatform API URL (if registered)

Need help?

If you run into issues during setup or configuration, reach out to the Fuwa & Company team.

Email supportBack to OWEN Pro