Files
proxmox/scripts/unifi
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00
..

UniFi Utility Scripts

Utility scripts for common UniFi Controller operations.

Available Scripts

list-sites.sh

List all sites in the UniFi Controller.

Usage:

./scripts/unifi/list-sites.sh

check-health.sh

Check UniFi controller health and connectivity.

Usage:

./scripts/unifi/check-health.sh

This script:

  • Verifies configuration in ~/.env
  • Tests controller connectivity
  • Tests API connection
  • Displays site information

list-devices.sh

Placeholder script for listing devices (currently not available in Official API).

Usage:

./scripts/unifi/list-devices.sh

test-integration.sh

Test suite to verify UniFi integration components are properly set up.

Usage:

./scripts/unifi/test-integration.sh

This script verifies:

  • Package builds
  • Configuration
  • Script executability
  • Documentation
  • API connection (if configured)

check-networks.sh

Check UniFi networks/VLANs configuration (requires Private API mode).

Usage:

./scripts/unifi/check-networks.sh

Note: Requires Private API mode and a non-2FA account. If your account has 2FA/SSO enabled, this script will not work. Use the web interface instead.

Requirements:

  • UNIFI_API_MODE=private in ~/.env
  • UNIFI_USERNAME and UNIFI_PASSWORD set
  • Account must NOT have 2FA/SSO enabled

Requirements

  • UniFi configuration in ~/.env
  • Node.js and pnpm installed
  • Python3 (for JSON formatting, optional)

Configuration

Ensure your ~/.env file contains:

UNIFI_UDM_URL=https://your-udm-ip
UNIFI_API_MODE=official
UNIFI_API_KEY=your-api-key
UNIFI_SITE_ID=default
UNIFI_VERIFY_SSL=false

Notes

  • Scripts use NODE_TLS_REJECT_UNAUTHORIZED=0 for self-signed certificates
  • For production, install proper SSL certificates and remove this workaround
  • Some endpoints may only be available in Private API mode