Tip:

Upgrading aaPanel will not affect the operation of the website. It only upgrades the aaPanel program and the python version environment it uses.
It is recommended to update when SSH or VNC is available. If the update fails, you can quickly handle it.
After upgrading, please press Ctrl + F5 to force refresh or use the browser to access in incognito mode.

Known issues:

Plug-ins and Professional programs in the App Store need to be updated to the latest version, otherwise they will not work properly.

If you encounter problems during use: 1. Take a screenshot of the error prompt, 2. Provide the operating system and system version you are using and feedback to the forum.

Problems you may encounter

1. How to deal with upgrade failure
You can also try to use the ssh tool to log in to the server and execute the update command with root privileges to update.
Update command:

curl -k https://node.aapanel.com/install/update_7.x_en.sh | bash

2. The network cannot connect to our node
Use the ssh tool to log in to the server and execute the command to check the server network:

curl -v https://node.aapanel.com
ping node.aapanel.com -c 5
ping google.com -c 5

Check whether the DNS of the operating system is set cat /etc/resolv.conf
If not set, execute the following command to set nameserver:

echo "nameserver 8.8.8.8" >> /etc/resolv.conf
echo "nameserver 1.1.1.1" >> /etc/resolv.conf

3. It may be that the system does not support Python 3.12 (usually an outdated system)

4. Insufficient space in /www partition
All partitions of /www can use at least 1G. It is recommended to clean or upgrade the server space before upgrading.
You can use this command to view the space df -h /www

5. Failed to download the file: Please try to use the update command line to update manually, and check whether the server network is normal?

6. Unable to access aaPanel after upgrade:
Use the ssh tool to log in to the server and check whether the bt service is started: bt status or sudo bt status
If it is not started, please start the bt service manually: bt start or sudo bt start
If it cannot start please check the log: bt 22

7. How to check the Python version used by aaPanel
View in the aaPanel Home interface:

Use the command to view:
/www/server/panel/pyenv/bin/python -V

8. After clicking "Update" from aaPanel, Python 3.7 is still displayed.
After updating to the latest version 7.x, the Python version will be automatically updated in the background.
If Python is still 3.7 after more than 15 minutes, it is recommended that you try to use the ssh tool to log in to the server and execute the update command.

9. How long does the upgrade take?
It takes 180 MB to download a file, which usually takes 1-2 minutes depending on the network speed of your server.
If you are using an operating system that does not have a pre-made Python environment package, it will take about 10 minutes or more. It is recommended to upgrade when the server is idle.
The operating systems of pre-made Python environment packages are not limited to the following systems:

CentOS, Red Hat, Oracle Linux: 7 8 9
Rocky linux, AlmaLinux: 8 9
Ubuntu: 18 20 22 23 24
Debian: 10 11 12

10. After the update is successful, you may need to use the full link to access aaPanel and be asked to log in.
Use the ssh tool to log in to the server and execute the command with root permissions to view the aaPanel access link: bt 14
If you forget your password, you can change it: bt 5

11. Is it possible to switch back to the old version 6.x?
Not recommended, the old version 6.x will no longer be maintained.

12. When using the Professional program in the App Store, an error message appears:
"load plugin failed: invalid plugin entry"

Please update the program to the latest version
If it is already the latest version and the error is still prompted, how to deal with it:
Find the wrong program on the App Store interface, click "Location" to enter the directory of the program you want to modify and find the info.json file
Modify the "versions" field to be lower than the current version, then save it, and finally update it manually in the App Store

Example: Nginx WAF
Nginx WAF info.json file /www/server/panel/plugin/btwaf/info.json
For example: "versions":"9.3.5", change to "versions":"9.3",
Then save, and finally go to the App Store to update manually

What do I need to do after upgrading?

It is recommended that you check whether aaPanel is running normally? Can it be used normally? If not, please take a screenshot of the error message and report it to the forum.
Check the Python version used by aaPanel 7.x . If it is not Python 3.12, aaPanel cannot be used normally. You can update manually using the update command
If you use Cron to back up data, please go to Cron to manually perform the task and observe whether there are any errors in the log?

If you encounter problems during use: 1. Take a screenshot of the error message, 2. Provide the operating system and system version you are using and provide feedback to the forum.