Grant Root Access

The Grant Root Access feature allows you to set up root access for your server through a simple and secure 3-step process.

When to use this feature

You should use the Grant Root Access feature in the following situations:

Password recovery without Master Key

When you recover your FlashPanel account password without entering the master key, the system cannot decrypt encrypted data. In this case, you need to use this feature to re-establish access and restore your ability to manage the server.

Public key lost or invalid

When the public key registered on your server is lost or becomes invalid for some reason (for example: accidentally deleted, server configuration changes, system errors), you will not be able to access the server through FlashPanel. This feature helps you create and install a new public key to restore the connection.

Note

This feature should only be used when absolutely necessary. If you can still access the server normally, you do not need to use this feature.

Overview

The root access grant process is performed through 3 sequential steps:

1. Generate Key - The system automatically generates an SSH key pair
2. Install - Copy and run the command on the server
3. Confirm - Enter your password to complete

Step 1: Generate Key

When you open the feature, the screen displays:

• Warning message about granting root access
• "Generate Key" button (pink) at the bottom right
• "Close" button (if available) to close the window

Actions

1. Read the warning message carefully
2. Click the "Generate Key" button to start
3. Wait for the system to generate the key (the button will show a loading state)

After the key is successfully generated, the screen automatically moves to step 2.

Step 2: Install

The screen displays:

• Title: "Copy this command and paste in terminal"
• Command box: Shows the commands that need to be run on the server, with a copy button
• "Back" button to return to step 1
• "Continue" button (blue) to proceed

Important

You must use an SSH client or VNC console (provided by your VPS provider) to access the server and run the provided command. This command only works when executed directly on the server, not on your local computer or within the FlashPanel interface.

Actions

1. Copy the command: Click the copy button in the command box to copy the entire command to your clipboard
2. Access the server: Use an SSH client (such as PuTTY, Terminal, or other SSH tools) or VNC console from your VPS provider to connect to the server
3. Paste and run the command: Paste the copied command into the terminal on the server and press Enter to execute
4. Wait for the command to complete execution
5. Click the "Continue" button to move to the final step

Note

The command is automatically generated for all Linux users on the server. You only need to copy and run it once.

Step 3: Confirm and Grant Access

The screen displays:

• Two warning messages:
  • Message about granting root access
  • Request to confirm your password for security
• Password field: Input field for your password
• "Back" button to return to step 2
• "Grant Root Access" button (red) to complete

Important

You need to enter your FlashPanel account password, not the root password of your VPS. This is the password you use to log in to the FlashPanel system.

Actions

1. Read the warning messages carefully
2. Enter your FlashPanel account password in the password field (not the VPS root password)
3. Click the "Grant Root Access" button to complete

After success, the system displays a confirmation message and automatically resets to step 1.

Error Handling

If an error occurs:

• Password error: Error message displays directly below the password input field
• Other errors: Error message displays as a notification on the screen

You can:

• Check the information you entered
• Try again from the corresponding step
• Use the "Back" button to return to previous steps

Security Notes

• Root access provides the highest level of access on the server
• Only grant access to trusted users
• Your password is encrypted and not stored in plain text
• After granting access, you can manage the server with root privileges