Resetting Admin Password on NG Firewall

Overview

This process can be used to reset the admin account password on NG Firewall. This process is completed through the command line interface (CLI), meaning that it is an unsupported change. Caution is advised for any CLI administration of NG Firewall.

If you simply want to change the admin password to the NG Firewall, we recommend doing so in the GUI, under Config > Administration > Admin instead. 

Please note: this article is only valid for NG Firewall installations running kernel 4.19 or higher. (How can I tell which kernel I'm using?)

Reset Process

1. Reboot the NG Firewall. To get into the GRUB menu, start pressing the up arrow rapidly after reboot so that the menu doesn't disappear after 3 seconds.

Note: This procedure may not work over KVM as some keyboards may not be detected while editing GRUB. 

2. Edit the GRUB boot options by selecting the version you want to use and press 'e' on the keyboard.

3. Use the arrow keys to move to the line starting with linux, highlighted here in yellow:

4. Add init=/bin/bash to the end of that line, then press Ctrl + X:

5. Use "mount -n -o remount,rw /" command to add read/write permissions to fresh mounted /:

6. Use "passwd" command to change root password. Ensure proper use of best practices for this password.

7. Use "exit" command to reboot system:

8. Once the system has come back up, click Terminal:

9. Log in with the new root password you created:

10. Enter the command "rm -f /usr/share/untangle/settings/untangle-vm/admin.js" to delete the admin JavaScript file:

11. Reboot your NG Firewall once more.

12. Log into the client via the Launch Client button

Your username is now admin

Your password is now passwd

IMPORTANT: Immediately change your password once you have logged in!