Quick start
- Install FASTPANEL
- NAT configuration
- Reset password
- Set panel address
- Set up SSH keys
- Uninstall FASTPANEL
- Update FASTPANEL
How to install FASTPANEL®
The panel can only be installed on a clean operating system without any preinstalled software. Installation on a server with preconfigured software is not possible!
In order to install FASTPANEL®, a virtual (VPS) or dedicated server with root access is required.
The server hardware must comply with the minimum system requirements:
RAM: 1G Free space: 5Gb CPU: 1 core, 1 Ghz
Supported operating systems are as follows (64-bit architecture only):
Debian: 9, 10, 11, 12
Ubuntu: 18.04, 20.04, 22.04, 24.04
CentOS: 7
AlmaLinux: 8
Rocky Linux: 8
After one of the supported OS is installed, it is necessary to perform the following actions:
-
Connect to the server via SSH using root-password:
ssh root@your.server -
Install the latest OS updates and the wget utility, which is required to run the control panel installation script. After that, reboot the server:
Debian / Ubuntu:
apt-get update && apt-get upgrade && apt-get install ca-certificates wget && rebootCentOS / AlmaLinux / Rocky Linux:
yum makecache && yum update && yum install ca-certificates wget && reboot -
After the server is rebooted, run FASTPANEL® installation process by executing a following command:
tipWhen installing the panel, you can choose the MySQL version. You can learn more in this article.
wget https://repo.fastpanel.direct/install_fastpanel.sh -O - | bash - -
After FASTPANEL® has been installed, you will get a message with the access data:
Congratulations! FASTPANEL successfully installed and available for you at https://1.2.3.4:8888
Login: fastuser
Password: password
FASTPANEL Extended is enabled by default for everyone. No license activation is required.
NAT configuration
On this page
NAT is a network address translation mechanism that translates packet IP addresses. NAT allows servers on a local network to work with servers on an external network.
If the server with FASTPANEL® has a private IP address, and NAT is configured on the local network, to ensure correct work with DNS domains, websites and mail services, you must configure the server's private and public IP addresses mapping.
To set up IP addresses mapping:
-
Open the left-side menu → "IP management" → "IP mapping"
-
Click "Add"
-
For the local IP addresses, enter the corresponding Public IP address
-
Click "Save"
After configuring the address mapping, internal IP addresses will be converted into external IP addresses when creating DNS domains.
List of ports for forwarding
For the correct operation of the main services, you need to configure forwarding for the following ports:
-
FASTPANEL: 8888, 7777
-
FTP: 21, 65000-65500
-
SSH: 22
-
SFTP: 2222
-
HTTP, HTTPS: 80, 443
-
IMAP, IMAPS: 143, 993
-
POP3, POP3S: 110, 995
-
SMTP, SMTPS: 25, 587, 465
-
DNS(if bind9 is used): 53
Other services, such as MySQL, typically only run on local IPs and do not require public access.
How to reset password
Introduction
FASTPANEL® provides two different ways to change any user’s password:
Changing password via FASTPANEL itself
This way is suitable if the previous password is known (the panel access isn’t lost).
To use this option you need to log in the FASTPANEL® and go to "Management" → "Users" menu, then click "Change Password"
In the modal window that opens, enter your old password, and then enter a new one twice, and after that click the "Save" button
Changing password via SSH
This way is suitable if the previous password is unknown (the panel access is lost). For changing password via SSH, old password is not required.
To use this option you need to:
-
Connect to your server via SSH using your root-password:
ssh root@your.server -
Use a command
passwd user_nameFor example, to change the password of the user named fastuser, the command should look like:
passwd fastuserAfter you run the command, it will require to enter and confirm a new password
noteno characters will be displayed on the screen during entering and confirming a new password.
-
If the password change was successful, you will get the following message:
passwd: password updated successfully
After that you may log in the panel using your new password
Set panel address
On this page
Introduction
In addition to standard access to FASTPANEL® by IP address, you can also set any domain or subdomain that is directed to your server with FASTPANEL® installed as the panel address.
To begin, please make sure that a valid A record exists for the domain name you want to use as your panel address. You can check this using the commands:
Windows:
nslookup example.comLinux/MacOS:
host example.comIf the A record is correct, you will see the following output:
example.com has address $IP_ADDRESSWhere instead of $IP_ADDRESS the IP address of your server should be specified. If a different address is present, please correct it in your DNS provider’s account and wait for the DNS cache to update. This process usually takes 20 to 60 minutes.
Setting the panel address
To set one of your domains or subdomains as a panel address, go to “Settings” -> “Main” -> “Panel addresses” and click the blue “Add address” button.
In the next window, add the domain you want to use as the panel address and click "Save".
After that FASTPANEL® will be available at an address:
example.com:8888Direct access
To configure direct access without specifying port 8888, click on the pencil icon next to the set panel address:
Then activate the "Direct access" checkbox and select the IP addresses that you want to use for this domain name:
And click "Save".
SSL certificate for the panel address
For the panel address, you can issue a free SSL certificate from Let's Encrypt, an existing paid certificate, or a self-signed certificate. To do this, click on the blue "SSL" text next to the panel address:
Then in the window that opens, select the certificate type:
And click "Save".
Possible problems
Please note that it is better to use a domain that is not behind Cloudflare as the FASTPANEL® address, as this may cause problems with FASTPANEL® when accessed by domain name due to limits on the Cloudflare side.
If problems arise when using such a domain, please check whether they are reproduced when accessing the panel by IP address. If not, please disable proxying for the domain name used as your FASTPANEL® address in the Cloudflare DNS section.
Set up SSH keys
On this page
In FASTPANEL® you can add SSH keys for users to simplify and secure server access.
SSH keys (Public Key Authentication) provide a secure and convenient way to access a server without using passwords, based on a pair of private and public keys. Instead of entering a password each time, the client uses the private key, while the server verifies it against the public key, improving both security and usability.
Key pair creation
Keep your private key safe and never share it with anyone.
First, you need to generate your private and public key pair.
macOS / Linux
Open a terminal and run:
ssh-keygenPress Enter to accept the default file location and set a passphrase if needed.
Your keys will be saved in ~/.ssh/id_ed25519 (private) and ~/.ssh/id_ed25519.pub (public).
Windows
OpenSSH
Open PowerShell and run:
ssh-keygenPress Enter to accept the default file location and set a passphrase if needed.
Your keys will be saved in C:\Users\YourUser\.ssh\id_ed25519 (private) and C:\Users\YourUser\.ssh\id_ed25519.pub (public).
PuTTYgen
- Download and install PuTTYgen.
- Launch PuTTYgen and click "Generate".
- Move your mouse cursor randomly over PuTTYgen window until generation process is finished.
- Save the private key (
.ppk) and copy the public key text.
Add a public key to the panel
Open FASTPANEL® and click on your username in the top-right corner of the screen. Then select "SSH Keys".
Click the "Add SSH key" button.
-
In the first field, paste your public key (it usually starts with
ssh-ed25519orssh-rsa, depending on the algorithm you chose) from the previous section. -
In the second field, you can add a description to help distinguish the key.
After that, you can connect to your server via SSH using your site owner’s credentials, without entering a password.
Enable SSH access and manage existing keys
If you need to manage other users’ keys or remove keys for the current user, go to "Management" → "Users". Click the three dots next to the user whose keys you want to manage.
In the opened section you can:
- Add a new key.
- Delete an existing key.
- Enable or disable SSH access for the user.
How to uninstall FASTPANEL®
If you want to switch from FASTPANEL® to a different control panel, reinstalling the operating system (OS) is the only way to proceed. Before doing so, it's crucial to back up all important data to an external storage. This will ensure you can restore your projects after the reinstallation.
FASTPANEL® can be uninstalled without disrupting the operation of sites. However, this will lead to consequences such as:
- Stopping automatic renewal of SSL certificates from Let's Encrypt issued through FASTPANEL®.
- Disabling backup tasks previously configured in FASTPANEL®.
- You will be able to change site settings, create and edit users, mailboxes, FTP/SFTP accounts, etc. only through manual configuration.
If you are certain you want to uninstall FASTPANEL® and fully understand the consequences, you can do so by executing the following commands in the server console as root:
Debian/Ubuntu:
apt-get remove fastpanel2 fastpanel2-nginxCentOS/AlmaLinux/RockyLinux:
yum remove fastpanel2 fastpanel2-nginxIf you need to restore FASTPANEL® operation in the future, you can reinstall previously uninstalled packages. However, there is no guarantee that the control panel will resume correct operation after this.
To install FASTPANEL® packages use the commands:
Debian/Ubuntu:
apt-get update
apt-get install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updaterCentOS/AlmaLinux/RockyLinux:
yum makecache
yum install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updaterHow to update FASTPANEL®
On this page
By default, FASTPANEL® is updated automatically according to the schedule set by the Cron scheduler. You do not need to take any additional actions for the panel to be updated.
Manual update
If for some reason it is necessary to force an update, execute the following console command via SSH:
/usr/local/fastpanel2/app/updaterAn executable file will be launched which will bring FASTPANEL® up to date with the latest version.
FASTPANEL