How To Adopt Unifi Switch Via Ssh

Adopting a UniFi switch via SSH is a common method for network administrators and IT professionals to gain direct access to their devices for configuration, troubleshooting, or initial setup. Unlike the standard UniFi Network Controller method, SSH provides a more manual approach, which can be particularly useful in certain scenarios such as adopting switches that are not yet configured or in environments where the controller isn't immediately accessible. In this guide, we'll walk through the step-by-step process of adopting a UniFi switch via SSH, ensuring you understand each phase from preparation to completion.

Understanding the Need to Adopt UniFi Switch via SSH

Before diving into the steps, it’s essential to understand why and when you might want to adopt a UniFi switch via SSH:

• Initial device setup in environments where the UniFi Controller isn't available or accessible.
• Recovering or re-adopting switches that have been reset or are unclaimed.
• Performing advanced configurations that are not available through the standard Controller interface.
• Automating device onboarding using scripts or command-line tools.

Adopting via SSH is a powerful method but requires a good understanding of network configurations, SSH protocols, and UniFi device management.

Prerequisites for SSH Adoption of UniFi Switch

Before starting, ensure you have the following:

• An active network connection to the UniFi switch.
• The default or known SSH login credentials for the device (default username/password or customized credentials).
• SSH client software such as PuTTY, Terminal (Mac/Linux), or any SSH-compatible tool.
• Knowledge of the device’s IP address or hostname.
• Access to the UniFi switch’s management interface or network to find the device’s IP address.

Note: If the device has been reset or is brand new, it may have default credentials. If the device was previously configured, use the existing credentials or reset the device if necessary.

Step-by-Step Guide to Adopt a UniFi Switch via SSH

1. Find the IP Address of the Switch

First, identify the IP address of the UniFi switch. You can do this through:

• Your network DHCP server or router’s connected device list.
• UniFi Network Controller’s device list (if accessible).
• Using network scanning tools like nmap or Angry IP Scanner.

Having the IP address is crucial because SSH connections require it for access.

2. Connect to the Switch via SSH

Open your SSH client and connect to the device using its IP address. The command typically looks like this:

ssh username@ip_address

For example, if the default username is `ubnt` and the IP address is `192.168.1.20`, enter:

ssh ubnt@192.168.1.20

If it's the first time connecting, you'll be prompted to accept the device's fingerprint. Confirm to proceed.

3. Log In Using SSH Credentials

Enter the password when prompted. The default credentials for many UniFi devices are:

• Username: ubnt
• Password: ubnt

If the device has been previously configured, use the custom password. If credentials are unknown, you may need to reset the device to factory defaults first.

4. Prepare the Device for Adoption

Once logged in, you will be in the device’s command-line interface (CLI). To prepare the switch for adoption, you need to set the device's inform URL to point to your UniFi Controller. Use the following command:

set-inform http://controller_ip_or_hostname>:8080/inform

Replace `controller_ip_or_hostname` with the IP address or hostname of your UniFi Controller.

For example:

set-inform http://192.168.1.100:8080/inform

This command tells the switch where to send its adoption request.

5. Confirm Adoption from the Controller

After executing the `set-inform` command, the switch will attempt to communicate with the controller. To check status, you can run:

info

Look for confirmation that the device is attempting to connect to the controller. On the Controller side, you should see the device appear as pending adoption.

6. Complete the Adoption Process

Once the switch communicates with the controller, it will show as "Adopting" or "Connected" depending on the status. If it doesn’t appear automatically, re-run the command:

set-inform http://controller_ip_or_hostname>:8080/inform

Sometimes, you might need to execute the command multiple times or restart the switch to facilitate the adoption process.

7. Verify the Adoption

Log into your UniFi Controller interface and navigate to the device list. The switch should now appear as adopted and managed under your network. You can then proceed to configure VLANs, port settings, or other advanced features through the controller.

Additional Tips and Troubleshooting

• Resetting the Device: If the switch does not respond or is unresponsive, perform a factory reset by pressing and holding the reset button for about 10 seconds. This restores default credentials and network settings.
• Using SSH Keys: For enhanced security, consider setting up SSH key authentication instead of passwords, especially for scripts or automated tasks.
• Firewall and Network Settings: Ensure that network firewalls allow SSH traffic (port 22) and that there are no network policies blocking communication between the switch and the controller.
• Persistent Adoption: Some devices may forget the inform URL after reboot. Consider configuring persistent settings or scripting the `set-inform` command to run on startup.
• Updating Firmware: Keep your switch firmware up to date to ensure compatibility and access to the latest features and security patches.

Conclusion

Adopting a UniFi switch via SSH provides a flexible and powerful way to manage your network devices, especially when traditional methods are unavailable or unsuitable. By following the steps outlined above, network administrators can efficiently connect, configure, and integrate switches into their UniFi ecosystem. Remember to exercise caution when working with device configurations at the command line, and always ensure you have backups and proper access rights before making significant changes. With practice, adopting UniFi switches via SSH becomes a straightforward process, enabling more granular control over your network infrastructure.

Disclaimer: Articles are written by Humans, AI or Both. Verify Important information.