First Connection

This page will guide you through establishing your first SSH connection.

Prerequisites

Before starting, ensure you have the following information:

• Server Address: IP address or domain name (e.g., 192.168.1.100 or server.example.com)
• SSH Port: Default is 22, some servers may use different ports
• Username: SSH login username (e.g., root, ubuntu)
• Authentication Method: Password or SSH key

Getting Server Information

If you're using a cloud server (Alibaba Cloud, Tencent Cloud, etc.), you can view the server IP and login information in your cloud provider's console.

Creating a Connection

Step 1: Open New Connection Window

After launching BShellX Pro, there are two ways to create a connection:

• Click the "New Connection" button on the left side of the main interface
• Use keyboard shortcut Ctrl+N (Windows/Linux) or Cmd+N (macOS)

Step 2: Fill in Connection Information

Fill in the information in the connection configuration window:

Field	Description	Example
Name	Display name for the connection	My Server
Host	Server IP address or domain	192.168.1.100
Port	SSH port number	22
Username	SSH login username	root
Authentication	Choose password or key authentication	Password

Password Authentication

After selecting "Password" authentication, you can choose:

• Enter Password Now: Enter password in the password field
• Enter on Connection: Enter password manually each time you connect (more secure)

Key Authentication

After selecting "Key" authentication:

1. Select the private key file path
2. If the private key has a passphrase, enter the key passphrase

SSH Key Generation

To generate an SSH key, use the command:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Step 3: Save Connection Configuration

After filling in the information:

1. Click the "Save" button to save the connection configuration
2. The connection will appear in the connection list on the left

Step 4: Establish Connection

Connection methods:

• Double-click the connection entry
• Right-click the connection entry → Connect
• Select the connection and click the "Connect" button

Step 5: Confirm Server Fingerprint

When connecting to a server for the first time, a security prompt will appear:

Security Notice

The server fingerprint is used to verify the server's identity. Please confirm that the fingerprint matches the information provided by your server provider to prevent connecting to malicious servers.

Click "Accept" to continue connecting.

Connection Successful

After a successful connection, the terminal interface will display:

• Server welcome message
• Command prompt (e.g., root@server:~#)
• Current path information

Connection Failure Troubleshooting

If connection fails, please check:

Error Message	Possible Cause	Solution
Connection refused	Wrong port or SSH service not running	Confirm port and SSH service status
Authentication failed	Incorrect username or password	Verify login credentials
Connection timeout	Network unreachable or firewall blocking	Check network and firewall rules
Host key verification failed	Server fingerprint changed	Delete old fingerprint record and reconnect

More Troubleshooting

If you encounter other connection issues, please refer to Connection Failure Troubleshooting.

Next Steps

After successful connection, you can:

• Learn Interface Overview - Master interface functions
• Start Trial Activation - Activate free trial
• Learn SSH Connection Features - Deep dive into SSH usage tips