> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atomicnetworks.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Connect to a VPS

> Learn how to connect to your VPS with this comprehensive, easy to follow guide.

In this guide, we will cover 2 of the most popular methods to connect to and manage a VPS using Secure Shell (SSH) and Virtual Network Computing (VNC). All of this information is accurate and applicable as of 2024.

<Check>
  If you are a current Atomic Networks VPS client, you can get started [in the VPS panel](https://vm.atomicnetworks.co/) right away! All you need to do is enter your email from your billing account and your password you set for your VPS in the sign in page.
</Check>

## Method 1: Connect to VPS via. SSH

### What is SSH?

SSH (Secure Shell) is a network protocol for secure communication and data sharing between computers. It offers strong authentication methods for safe interaction over open networks.

Used by administrators to manage Linux systems remotely, SSH allows logging in, executing commands, and transferring files between computers. It ensures secure communication between a remote host and a local machine.

### Requirements for Logging into a VPS via. SSH

To connect to a VPS via. SSH, you will need to have the following information:

* IP Address
* Username
* Password

<Info>If you are an Atomic Networks VPS client, you can find this information in the onboarding email sent to you following purchase. See our guide on [getting VPS credentials](/vps/getting-vps-credentials) for more details.</Info>

### How to Connect to VPS via. SSH

Once you have found your credentials, you will need to have an SSH client on your PC. Click the dropdown below to find your connection method for your operating system.

<AccordionGroup>
  <Accordion title="Connect to VPS via. SSH on Windows" icon="windows">
    To connect to a VPS via. SSH with Windows, you will need to download an SSH client. This guide will use [PuTTy](https://www.putty.org/) as the SSH client for Windows users.

    <Steps>
      <Step title="Download PuTTy">
        Download the latest version of PuTTy from the website. Remember to select the correct bit version for your computer.
        <Info>You can double check your bit version by searching for 'System Information' in the Windows search bar and checking the 'System Type'</Info>
      </Step>

      <Step title="Launch the PuTTy Client">
        <img height="100px" src="https://mintcdn.com/atomicnetworks/m8FVQg74mcrYFl7b/images/putty-config-image.png?fit=max&auto=format&n=m8FVQg74mcrYFl7b&q=85&s=95950e9f604315e0e37fd2d135f1913f" data-path="images/putty-config-image.png" />

        Once logged in, a 'Login As' message will show. This menu will ask you to input your SSH credentials you found in our [getting credentials](/vps/getting-vps-credentials) guide.
      </Step>

      <Step title="Enter Your Credentials">
        Using your details, input your SSH password and username. When you enter your password, it will not show you your entered credentials. Note that this is a security measure. PuTTy will still register what you have typed.

        Congratulations! You have connected to your VPS with the PuTTy SSH client.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Connect to VPS via. SSH on MacOS" icon="apple">
    Connecting to a VPS through MacOS can be done through the built in Terminal.

    <Steps>
      <Step title="Open the Terminal">
        To open the terminal in MacOS, open spotlight by pressing `Cmd + Space` and typing `Terminal` in the search bar.
      </Step>

      <Step title="Run the SSH Command">
        In the terminal, enter the command \`ssh username\@ipaddress' but replace the following:

        * Replace `username` with the user name you were provided.
        * Replace `ipaddress` with the IP Address/Hostname of your server.
      </Step>

      <Step title="Press the Enter Key">
        If it's the first time you are connecting to this machine, it will warn you that your server key is not cached in the registry. Type `Yes` and press `Enter`.
      </Step>

      <Step title="Enter Your Password">
        Enter the password provided to you in your credentials email in the terminal.

        <Info>
          For security purposes, your SSH password will not be shown on the screen as you enter it.
        </Info>
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Connect to VPS via. SSH on Linux" icon="linux">
    Connecting to a VPS through most Linux distributions can be done through the Terminal. Below are some of the commands needed to install SSH components into popular Linux Distributions.

    <Tabs>
      <Tab title="For Debian/Ubuntu Based Systems">
        Run the following command on the client.
        `sudo apt install openssh-client`

        Run the following command on the server.
        `sudo apt install openssh-server`
      </Tab>

      <Tab title="For Red-Hat Based Systems (ex. CentOS/Fedora)">
        Run the following commands on the client.

        `sudo dnf install openssh-clients`

        `sudo yum install openssh-clients`

        Run the following commands on the server.

        `sudo dnf install openssh-server`

        `sudo yum install openssh-server`
      </Tab>
    </Tabs>

    After the components are installed, the SSH service should automatically start. You can check the SSH service status with `systemctl status sshd`

    If the service is not running, use the `sudo systemctl start sshd` command. This command does not print an output.

    To set the service to automatically start on boot, run the `sudo systemctl enable sshd` command.
    <Info> Note: On some systems, sshd is the service name alias, and the commands will not work. In that case, replace sshd with ssh in the previous commands.</Info>
    If you are unable to establish an SSH connection via. the terminal through your Linux Distribution, follow the steps below to download PuTTy Client.

    <Steps>
      <Step title="Download PuTTy">
        Download the latest version of PuTTy from the website. Remember to select the correct bit version for your computer.
      </Step>

      <Step title="Launch the PuTTy Client">
        <img height="100px" src="https://mintcdn.com/atomicnetworks/m8FVQg74mcrYFl7b/images/putty-config-image.png?fit=max&auto=format&n=m8FVQg74mcrYFl7b&q=85&s=95950e9f604315e0e37fd2d135f1913f" data-path="images/putty-config-image.png" />

        Once logged in, a 'Login As' message will show. This menu will ask you to input your SSH credentials you found in our [getting credentials](/vps/getting-vps-credentials) guide.
      </Step>

      <Step title="Enter Your Credentials">
        Using your details, input your SSH password and username. When you enter your password, it will not show you your entered credentials. Note that this is a security measure. PuTTy will still register what you have typed.

        Congratulations! You have connected to your VPS with the PuTTy SSH client.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Method 2: Connect to VPS via. VNC

### What is VNC?

VNC, or Virtual Network Computing, is a graphical desktop-sharing system that uses the Remote Frame Buffer (RFB) protocol to remotely control another computer's desktop environment. It allows a user to view and interact with the graphical desktop of a remote system over a network connection.

VNC works by transmitting the graphical display updates from the remote system to the client software running on the local system, and it sends user input events (such as mouse and keyboard actions) back to the remote system.

<Warning>Atomic Networks does not recommend connecting to a VPS via. VNC for production use cases unless it is absolutely necessary. VNC protocol has a large number of security vulnerabilities.</Warning>

<Check> If you are a current Atomic Networks client, you can connect to your VPS via. VNC through the panel at vm.atomicnetworks.co</Check>

<img src="https://mintcdn.com/atomicnetworks/m8FVQg74mcrYFl7b/images/click-vnc-button.png?fit=max&auto=format&n=m8FVQg74mcrYFl7b&q=85&s=6680b51559eb1bf4bd98dde958f225ef" width="1376" height="219" data-path="images/click-vnc-button.png" />

### Requirements for Logging into a VPS via. VNC

To connect to a VPS via. VNC, you will need to have the following information:

* IP Address
* Username
* Password

<Info>If you are an Atomic Networks VPS client, you can find this information in the onboarding email sent to you following purchase. See our guide on [getting VPS credentials](/vps/getting-vps-credentials) for more details.</Info>

### Video Guide for Connecting via. VNC

Need to see someone else do the VNC connection? Watch this easy to follow video tutorial!

<iframe width="560" height="315" src="https://www.youtube.com/embed/woZL9wmKdz4?si=KNm5R7ZaoUToQbdG" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
