Ubiquiti UniFi Error Code 'Adopt Failed: SSH Error': How to Fix It

Medium 15-45 minutes Medium Severity Verified June 2026
Error Code
Adopt failed: SSH error
Brand
Ubiquiti UniFi
Product Type
networking
Severity
Medium
DIY Difficulty
Medium
Estimated Fix Time
15-45 minutes
The 'Adopt failed: SSH error' message appears when your UniFi Controller cannot establish a secure connection to adopt a new access point. This typically happens when the AP has custom SSH credentials that don't match the controller's default settings, or when network connectivity issues prevent proper communication.
Ad

Tools You'll Need

How to Fix Error Code Adopt failed: SSH error

  1. Reset AP to Factory Defaults

    Ensure the AP remains powered during the reset process. Losing power during reset can cause firmware corruption.
  2. Verify Network Connectivity

  3. Use SSH to Reset Credentials Manually

    Only attempt SSH access if you're comfortable with command-line interfaces. Incorrect commands can disable the AP.
  4. Check Controller SSH Settings

  5. Retry Adoption Process

  6. Use Discovery Tool for Stubborn Devices

Parts You May Need

PoE injector or switch
Check Price on Amazon
PoE injector or switch
Check Price on Amazon
PoE injector or switch
Check Price on Amazon
PoE injector or switch
Check Price on Amazon
PoE injector or switch
Check Price on Amazon
PoE injector or switch
Check Price on Amazon
PoE injector or switch
Check Price on Amazon
PoE injector or switch
Check Price on Amazon
Ad

When to Call a Professional

Contact Ubiquiti support or a network professional if the AP remains unresponsive after factory reset, if you're uncomfortable with SSH commands, or if multiple APs are experiencing adoption issues which may indicate broader network infrastructure problems.

Frequently Asked Questions

Why does my UniFi AP keep showing SSH adoption errors?
SSH adoption errors typically occur when the AP has custom credentials that don't match the controller's settings, or when there are network connectivity issues. Factory resetting the AP usually resolves credential mismatches.
What are the default SSH credentials for UniFi devices?
The default SSH username is 'ubnt' and the default password is 'ubnt'. These credentials are reset when you perform a factory reset on the device.
Can I adopt UniFi devices across different subnets?
Yes, but you need to use Layer 3 adoption by manually specifying the controller's IP address via SSH command: set-inform http://[controller-ip]:8080/inform
How long should UniFi device adoption take?
Normal adoption takes 2-5 minutes. If it takes longer than 10 minutes or fails repeatedly, there's likely a network connectivity or credential issue that needs troubleshooting.
What if my UniFi AP won't reset to factory defaults?
Try holding the reset button for 30 seconds instead of 10-15. If that fails, the device may need TFTP recovery or have hardware issues requiring replacement.