Configuration Guide

# PrintMaster Agent Configuration

# Asset ID regex pattern for extracting asset tags from device data
asset_id_regex = "\\b\\d{5}\\b"

# Number of concurrent SNMP queries (adjust based on network capacity)
discovery_concurrency = 50

# Enable Epson remote-mode commands (experimental)
epson_remote_mode_enabled = false

[snmp]
  # Default SNMP community string
  community = "public"
  
  # SNMP timeout in milliseconds
  timeout_ms = 2000
  
  # Number of retries for failed SNMP queries
  retries = 1

[web]
  # HTTP port for web UI
  http_port = 8080
  
  # HTTPS port (if TLS enabled)
  https_port = 8443
  
  # Enable TLS/HTTPS
  enable_tls = false
  
  # TLS certificate file (if enable_tls = true)
  # cert_file = "/path/to/cert.pem"
  
  # TLS key file (if enable_tls = true)
  # key_file = "/path/to/key.pem"

[web.auth]
  # Authentication mode: local, server, disabled
  mode = "local"
  
  # Allow admin access from localhost without login
  allow_local_admin = true

[server]
  # Enable server upload mode
  enabled = false
  
  # PrintMaster Server URL
  url = "http://printmaster-server:9090"
  
  # Friendly name for this agent
  agent_name = "Main Office"
  
  # Path to server CA certificate (for self-signed certs)
  ca_path = ""
  
  # How often to upload discovery data (seconds)
  upload_interval_seconds = 300
  
  # How often to send heartbeat (seconds)
  heartbeat_interval_seconds = 60
  
  # Authentication token (if server requires it)
  token = ""

[database]
  # SQLite database path (blank = default location)
  path = ""

[logging]
  # Log level: debug, info, warn, error
  level = "info"

[auto_update]
  # Update mode: inherit, local, disabled
  mode = "inherit"

  [auto_update.local_policy]
    # Days between update checks
    update_check_days = 7
    
    # Version pin strategy: minor, major
    version_pin_strategy = "minor"
    
    # Allow major version upgrades
    allow_major_upgrade = false
    
    # Pin to specific version (blank = latest)
    target_version = ""
    
    # Send telemetry data
    collect_telemetry = true

    [auto_update.local_policy.maintenance_window]
      enabled = false
      timezone = "UTC"
      start_hour = 2
      start_min = 0
      end_hour = 5
      end_min = 0
      days_of_week = ["Sunday"]

    [auto_update.local_policy.rollout_control]
      staggered = true
      jitter_seconds = 300

# PrintMaster Server Configuration

[web]
  # HTTP port
  http_port = 9090
  
  # HTTPS port
  https_port = 9443
  
  # Enable TLS
  enable_tls = false
  
  # Bind address
  bind_address = "0.0.0.0"

[database]
  # Database type: sqlite, postgres
  type = "sqlite"
  
  # SQLite path (if type = sqlite)
  path = "/var/lib/printmaster/server/printmaster.db"
  
  # PostgreSQL connection string (if type = postgres)
  # postgres_url = "postgres://user:pass@host:5432/printmaster"

[logging]
  # Log level: debug, info, warn, error
  level = "info"
  
  # Log file path (blank = stdout only)
  file = "/var/log/printmaster/server/server.log"

[auth]
  # Session timeout in hours
  session_timeout_hours = 24
  
  # Allow registration (multi-tenant mode)
  allow_registration = false

[self_update]
  # Enable server self-update feature
  enabled = true
  
  # Release channel: stable, beta
  channel = "stable"
  
  # Check interval in minutes
  check_interval_minutes = 360

[releases]
  # Max releases to cache
  max_releases = 6
  
  # Poll interval for new releases
  poll_interval_minutes = 240

[database]
type = "sqlite"
path = "/var/lib/printmaster/server/printmaster.db"

[database]
type = "postgres"
postgres_url = "postgres://printmaster:password@localhost:5432/printmaster?sslmode=disable"

environment:
  - ADMIN_PASSWORD=secure-password
  - BIND_ADDRESS=0.0.0.0
  - LOG_LEVEL=info
  - BEHIND_PROXY=true
  - PM_DISABLE_SELFUPDATE=true

[Service]
Environment=SERVER_ENABLED=true
Environment=SERVER_URL=https://printmaster.example.com:9443
Environment=AGENT_NAME=office-hq
Environment=LOG_LEVEL=info

printmaster-agent [options]

Options:
  -config string
        Path to configuration file
  -port int
        HTTP port (default 8080)
  -data-dir string
        Data directory path
  -log-level string
        Log level: debug, info, warn, error
  -service string
        Service command: install, uninstall, start, stop, run
  -quiet
        Suppress informational output
  -help
        Show help
  -version
        Show version

printmaster-server [options]

Options:
  -config string
        Path to configuration file
  -port int
        HTTP port (default 9090)
  -data-dir string
        Data directory path
  -log-level string
        Log level: debug, info, warn, error
  -help
        Show help
  -version
        Show version