diff --git a/documentation/docs/admin/settings/general.md b/documentation/docs/admin/settings/general.md index b6cea123..bb51e09d 100644 --- a/documentation/docs/admin/settings/general.md +++ b/documentation/docs/admin/settings/general.md @@ -8,17 +8,27 @@ Change ports, domain, enable ssl, etc. ![openadmin general panel settings](/img/admin/adminpanel_general_settings.png) -The General Settings page enables you to specify the domain name for accessing both the admin and user panels, with an option to switch to an IP address. +The General Settings page enables you to edit settings that affect both admin and user panel: + +- domain to access panels +- ports to be used +- update preferences ## Set domain for OpenPanel To enable access to both OpenAdmin and OpenPanel through a domain name, such as srv.your-domain.com:2083, follow these three steps: -1. Set the desired name as the server hostname. -2. Point the domain name to the public IP of the server. -3. Configure the domain name in OpenAdmin under OpenAdmin Settings. - -Completing these steps will allow users to access both OpenAdmin and OpenPanel using the specified domain name and port. +1. Set hostname: + Set the desired subdomain as server hostname: + ``` + hostnamectl set-hostname server.example.net + ``` +2. Configure DNS: + Point the subdomain to the public IP of the server. + Use a tool such as https://www.whatsmydns.net/ to check that domain is pointed to server ip. + +3. Set in General Settings + Switch from IP to the domain name in *OpenAdmin > General Settings*. ![openadmin set_domainname](/img/admin/adminpanel_domainname.png) @@ -30,22 +40,21 @@ To access OpenPanel and OpenAdmin via server public IP address, choose the "Serv ## Change OpenPanel port -Port configurations for OpenAdmin and OpenPanel interfaces can be modified from their default settings (2087 for OpenAdmin and 203 for OpenPanel). +Port configurations for OpenAdmin and OpenPanel interfaces can be modified from their default settings (2087 for OpenAdmin and 2083 for OpenPanel). ![openadmin set port for openpanel](/img/admin/openpanel_settings.png) -To modify the port for the OpenPanel from the default `2083` to another value, you can easily set the desired port in the "OpenPanel Port" field. +To change the port for the OpenPanel from the default `2083` to another value, you can easily set the desired port in the "OpenPanel Port" field. It's important to note that the port must fall within the range of 1000-33000. ## Change OpenAdmin port -Port configurations for OpenAdmin and OpenPanel interfaces can be modified from their default settings (2087 for OpenAdmin and 203 for OpenPanel). +:::info +NOTE: Changing admin port from 2087 is currently not possible, as external tools such as WHMCS do not have option to set custom port. +::: ![openadmin set port for openadmin](/img/admin/openadmin_settings.png) -To modify the port for the AdminPanel from the default `2087` to another value, you can easily set the desired port in the "OpenAdmin Port" field. -It's important to note that the port must fall within the range of 1000-33000. - # Force HTTPS @@ -54,7 +63,7 @@ To activate HTTPS, select the "Force HTTPS" option; to deactivate, simply unchec # Change /openpanel -By default, when users add a domain, the addition of "/openpanel" to the domain URL will redirect them to the OpenPanel interface. However, you have the flexibility to customize this, such as changing it to "/awesome," allowing users to access the OpenPanel via "their-domain.com/awesome". +By default, when users add a domain, the addition of "/openpanel" to the domain URL will redirect them to the OpenPanel interface. However, you have the flexibility to customize this, such as changing it to "/awesome," allowing users to access their OpenPanel via "their-domain.com/awesome". To change the "/openpanel" to something else, simply set the value for the "OpenPanel is also available on:" field and click on save. Changes take effect instantly without service interruption. ![openadmin set custom path](/img/admin/openpanel_settings_available_on_openpanel.png)