Skip to content

Prerequisite: Installing SSH on Windows

Windows 10 and 11 usually already include the SSH client. If the ssh command does not work in PowerShell, install it like this:

  1. Open the Start menu and search for PowerShell.

  2. Right-click PowerShell and choose Run as Administrator.

    PowerShell, Run as Administrator

  3. Run this command in PowerShell:

    Add-WindowsCapability -Online -Name OpenSSH.Client

  4. When it finishes, you should see something like this:

    OpenSSH client installed

The SSH client is now installed.

How to connect and troubleshoot via SSH

This page shows you how to manage Hiddify Manager from your server's command line when the web panel does not open, or when you have lost your admin link. It also explains each option of the Hiddify menu.

SSH is a secure way to open a text terminal on your server from your own computer or phone. Everything you type runs on the server.

Prerequisites

  • Your server's IP address.
  • The server's username (usually root) and password or SSH key. Your server provider gives you these.
  • An SSH app on your device:
    • Android: Termius
    • Windows: PowerShell (or PuTTY)
    • macOS: Terminal
    • Linux: Terminal

For a full guide, see How to connect to the server via SSH.

Connect to the server

  1. Open your SSH app.

  2. Run this command on your device. Replace user with your username and <IP_Address> with your server's IP:

    ssh user@<IP_Address>

    For example, if your username is root and your server's IP is 1.1.1.1:

    ssh root@1.1.1.1

  3. Type yes if you are asked to trust the server, then enter your password. (The password is not shown while you type. This is normal.)

If the connection works, you see the server's command prompt, and the Hiddify menu may open by itself.

Password login warning

If password login is enabled on your server, the menu first shows a WARNING that your server is open to abuse. Press Enter to continue. To fix it, follow Disable SSH password authentication.

Open the Hiddify menu

Run this command on your server to open the Hiddify menu:

hiddify

The menu looks like this (the screenshots on this page are from an older version, so some items may look a little different):

Hiddify Manager menu

Use the arrow keys to move, and press Enter to choose an item. The sections below explain each item.

Commands instead of the menu

Most menu items are also available as direct commands, for example hiddify status, hiddify admin, hiddify restart, hiddify apply and hiddify upgrade release. Run hiddify --help to see them all.

Cancel or Quit

Choose Quit (or press Cancel / Esc) to leave the menu and go back to the normal server terminal.

To open the menu again, run this command on your server:

hiddify

Status

Shows whether each Hiddify service is running. If everything is fine, the result looks like this:

Status

Press q to return to the main menu.

When to use it: to check quickly whether all services are running.

Admin

Shows your admin panel links. Open one of the links marked Secure (on your domain) in your browser. Use the Not Secure IP link only if no domain link works.

Admin

On this screen you can also press r to reset the owner admin password. Press any other key to return to the main menu.

The same links are printed by this command:

hiddify admin

When to use it: you installed the panel but forgot to copy the admin link.

Log

Shows the system logs. After you choose it, pick the log file you want to read.

Log

For example, choose the install log to see what happened during installation. At its end, it shows the system status and the admin links.

Install log

Press q to close the log. The log files are stored on the server in /opt/hiddify-manager/data/log/.

When to use it: one of the services is not working and you need to see why.

Restart

Restarts all Hiddify services without changing any settings.

Restart

Press any key to return to the main menu.

When to use it: a service has stopped and you want to restart all services at once.

Apply configs

The menu no longer has an "Apply Configs" item. To apply the settings you saved in the panel, run this command on your server:

hiddify apply

Apply Configs

When to use it: you saved changes in the panel but lost web access before you could apply them.

Install

Reinstalls Hiddify Manager on the server. Your panel data (users, settings, domains) is kept.

When to use it: an install step failed and the panel does not open.

Update

Updates Hiddify Manager to the latest version. It offers these options:

Update

  • default: updates to the channel chosen in the panel settings.
  • release: updates to the latest stable version (recommended).
  • beta: updates to the latest pre-release version. It may have bugs.

You can also update with a command, for example:

hiddify upgrade release

While it runs, the terminal shows something like this:

Update running

When to use it: an update from the web panel failed and you lost access.

Advanced

This submenu has several options.

Advanced

warp

Shows the status of the WARP service.

add_remote

Gives the Hiddify support team SSH access to your server, through the Hiddify bot. Use it only when the support team asks you to.

remove_remote

Removes the SSH access you gave to the Hiddify bot.

enable

Shows the Hiddify menu automatically every time you log in to the server over SSH. Use it if you turned this off before.

disable

Stops the Hiddify menu from opening automatically when you log in. You can still open it with hiddify.

uninstall

Removes Hiddify Manager services from the server. It does not remove everything that was installed. If you want the server exactly as it was before the installation, rebuild it from your provider's control panel.

purge

Removes Hiddify Manager and its database completely. All users and settings are deleted, so take a backup first.

If this does not work for any reason, you can Rebuild the server from your provider's control panel. This deletes all data on the server.

Last update: November 6, 2026

Comments