RunSAFi

Onboarding Guide

Getting Started with Your SAFi Appliance

Step-by-step instructions for unboxing, network connectivity, web portal access, and pairing your desktop CLI.

1

Connect the Appliance to Your Network

Place the appliance in your server rack, network closet, or workstation desk. Connect a monitor using an HDMI cable, plug in a keyboard and mouse, connect the power adapter, and turn on the appliance.

Your appliance will boot normally until you reach the configuration console screen where you will connect it to your local network.

Network Connection Options

Option A: Wired Ethernet (Recommended)

Connect a standard CAT6/RJ-45 Ethernet cable from your network switch or router into the appliance Ethernet port. From the on-screen menu, choose "Network Configuration Manager" and then select "Configure Wired Network (DHCP)".

Option B: Wi-Fi Setup

From the "Network Configuration Manager", choose "Connect to Wi-Fi" to scan for available networks. Select your SSID, enter your network password, and connect.

Appliance Management URL: After connecting to your network, the console screen will display your Appliance Management URL (for example: https://192.168.1.200). Note down this address for Step 2.

2

Log into the Web Management Portal

Once connected to your local network, access the appliance web interface from any workstation or laptop on the same subnet:

  1. Open your web browser and navigate to: https://<appliance-ip>/ using the IP address you noted above.
  2. Accept the local self-signed TLS certificate or download https://<appliance-ip>/appliance.crt and install it to your trusted root certificates.
  3. Enter your username and password:
    • Default Username: admin
    • Default Password: @ppliance

Security Recommendation: Once logged in, you can immediately change your default password by navigating to "My Profile" in the top navigation menu.

3

Install the SAFi CLI on Your Desktop

The SAFi CLI allows engineers, sysadmins, and developers to use the agents using the Linux or PowerShell command line.

Windows 10 / 11 (PowerShell)

Install SAFi CLI directly from PowerShell (automatically configures WSL and all operational tools including OpenSSH, sshpass, nmap, and jq):

irm https://runsafi.com/install.ps1 | iex
Linux & macOS (Terminal)

On native Linux or macOS systems, install the SAFi CLI with this command:

curl -sSL https://runsafi.com/install.sh | bash

First-Time Configuration: Once installed, launch the onboarding wizard by running:

safi-cli --setup

Enter your appliance URL (e.g. https://192.168.1.200) and log in with your credentials to connect your workstation to the appliance.

Need Assistance?

Our team is available to help with your appliance setup or any question you might have getting started.

Call at 617-294-9860 or email help@runsafi.com.