Skip to content

How to connect and troubleshoot via SSH

Prerequisite: Installing ssh on Windows

- If your client is Windows; You can use Powershell. First, if you haven't installed the OpenSSH module yet; Open PowerShell with admin access, that is, right-click PowerShell and click Run as Administrator. ![image](https://user-images.githubusercontent.com/114227601/222904592-cd26b3bf-a014-4253-9488-ee9717f006fe.png) Then run this command:
Add-WindowsCapability -Online -Name OpenSSH.Client
After that you should see something like this: ![image](https://user-images.githubusercontent.com/114227601/222904870-e709f69e-1a8d-4a6d-ad6a-3d7bdcd917c3.png) Congratulations, ssh installation is complete.

How to connect and troubleshoot via SSH

If for any reason access to the panel is not available through the web or your access is cut off and you do not have the emergency link; In this case, the only way to control and apply changes, as well as restore web access, is through the terminal.

In this case, you need to ssh to the server first. for this job: According to your operating system, open one of the following programs - Windows: PowerShell - Mac: Terminal - Linux: Terminal

Then connect to the server by running the following command: ssh user@<IP_Address>

Usually, when you purchase a VPS you get the user ``root'' on the server. suppose your server's IP is 1.1.1.1, so the command is as follows:

ssh root@1.1.1.1
After connecting to the server, the panel menu will be shown like this.

For more information, each part will be explained separately.

Cancel

By selecting cancel, you can exit the menu and reach the normal terminal of the server.

Note: To return to the menu, you must run this command in the terminal.

bash /opt/hiddify-config/menu.sh

Status

This menu is used to know the status of the system, if everything is normal, the result should be displayed like this.

Screenshot_20230304_111551

To return to the main menu, you must press the q key.

Admin

This section displays admin links. If you need these links for any reason, use this option.

Screenshot_20230304_112037

Press a key to return to the main menu.

Most used:

If you installed the panel but forgot to copy the admin links.

Log

Used to view system logs. After selecting it, you must also select the desired log type.

Screenshot_20230304_111751

For example, if we want to see the logs related to the installation, we can choose the install-log option.

Screenshot_20230304_111851

Here, the installation logs are displayed as above, at the end of which the system status and admin links are displayed.

Most used:

If one of the services is not working properly and you need to check its log.

Restart

This option resets all panel services without changing the settings.

Screenshot_20230304_111723

You can return to the main menu by pressing any of the buttons on the keyboard.

Most used:

If one of the services is disabled and you need to reset all services at once.

Apply Configs

This section is used to apply saved settings. After selecting it, the panel will start resetting the values.

Screenshot_20230304_111935

Press any key to return to the main menu.

Most used:

If you registered changes in the panel, but for any reason you lost web access

Update

This option is used to update the system. If you select that panel, it will be updated to the latest version available on the project's GitHub. There are three options here as follows.

Screenshot_20230405_160338

Default

By selecting this option, the program will be updated according to the setting of the web panel.

Release

By selecting this option, the program will be updated to the latest stable version.

Develop

By selecting this option, the program will be updated to the latest development version.

In all three cases, you will see something like this in the terminal.

Screenshot_20230304_112008

Most used:

If you lost access during the update through the panel.

Install

If you need to reinstall the system, use this option. At the end, the system status and admin links are displayed.

Screenshot_20230304_111851

To return to the main menu, you must press the q key.

Most used:

If during installation one of the scripts is not executed correctly and the panel does not open.

This submenu contains several options.

Screenshot_20230405_160357

Enable

This option is for when you have previously disabled the display of this window and want to re-enable its automatic display at server startup.

Disable

By selecting this option, the display of this window will be disabled at startup. That is, if the server is restarted, this window will no longer be displayed automatically.

Uninstall

If you need to remove the installed panel from the server, use this option. Also, keep in mind that this option does not remove all uninstalled items. If you need the server to return to the default settings before installation; It is better to rebuild it.

Purge

Select this option to completely remove the program and database from the server.

If this method did not work for you for any reason, you can Rebuild the server through your data center. This will delete all server data.


Last update: April 17, 2024

Comments