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

# Connect from Ubuntu / Linux

> Below you can find the step by step process to log into your forex VPS from Ubuntu or other Linux distributions.

***

## Option 1: Using Remmina (Recommended)

<Steps>
  <Step title="Receive VPS Credentials">
    After your order is complete, you'll receive an email with your VPS login credentials. Wait **at least 10 minutes** after receiving this email to ensure the Windows installation is fully ready.
  </Step>

  <Step title="Install Remmina">
    Open a **Terminal** and install Remmina if not already installed:

    ```bash theme={null}
    sudo apt update
    sudo apt install remmina remmina-plugin-rdp
    ```

    For other distributions, use your package manager (dnf, pacman, etc.).
  </Step>

  <Step title="Launch Remmina">
    Open **Remmina** from your applications menu or type `remmina` in the terminal.
  </Step>

  <Step title="Create New Connection">
    Click the **"+"** button to create a new connection profile. Configure as follows:

    * **Protocol**: RDP
    * **Server**: Your VPS IP address from the email
    * **Username**: `Administrator`
    * **Password**: (copy from your email)
    * **Resolution**: Use client resolution or select preferred
  </Step>

  <Step title="Save and Connect">
    Click **Save and Connect**. If a certificate warning appears, click **Accept**.
  </Step>

  <Step title="Access VPS Desktop">
    Your Windows VPS desktop will appear in the Remmina window. You can toggle fullscreen with **Ctrl+F**.
  </Step>
</Steps>

***

## Option 2: Using xfreerdp (Command Line)

<Steps>
  <Step title="Install xfreerdp">
    Open a **Terminal** and install xfreerdp:

    ```bash theme={null}
    sudo apt update
    sudo apt install freerdp2-x11
    ```

    For other distributions, the package may be named `freerdp` or `xfreerdp`.
  </Step>

  <Step title="Prepare Connection Command">
    Copy your VPS credentials from the welcome email. You'll need:

    * **IP Address**
    * **Username**: `Administrator`
    * **Password**
  </Step>

  <Step title="Connect via Terminal">
    Run the following command, replacing `YOUR_IP` and `YOUR_PASSWORD`:

    ```bash theme={null}
    xfreerdp /v:YOUR_IP /u:Administrator /p:YOUR_PASSWORD /cert:ignore /dynamic-resolution
    ```

    For better performance, you can add:

    ```bash theme={null}
    xfreerdp /v:YOUR_IP /u:Administrator /p:YOUR_PASSWORD /cert:ignore /dynamic-resolution /compression /network:lan
    ```
  </Step>

  <Step title="Handle Certificate Warning">
    When prompted about the certificate, type **Y** and press **Enter** to accept and continue.
  </Step>

  <Step title="Access VPS Desktop">
    The VPS desktop will open in a new window. Use these shortcuts:

    * **Ctrl+Alt+Enter**: Toggle fullscreen
    * **Ctrl+Alt+F**: Toggle window decorations
  </Step>
</Steps>

***

## Troubleshooting Tips

<AccordionGroup>
  <Accordion title="Connection Refused Error">
    If you receive a "connection refused" error:

    * Verify the IP address is correct
    * Wait at least 10 minutes after receiving credentials
    * Check if port 5909 is blocked by your firewall: `sudo ufw allow 5909/tcp`
  </Accordion>

  <Accordion title="Black Screen After Login">
    If you see a black screen after connecting:

    * Wait 30-60 seconds for the desktop to load
    * Try disconnecting and reconnecting
    * In Remmina, try changing color depth to "True Color (24 bpp)"
  </Accordion>

  <Accordion title="Clipboard Not Working">
    To enable clipboard sharing:

    * **Remmina**: Enable "Use client resolution" in Advanced tab
    * **xfreerdp**: Add `/clipboard` to your connection command
  </Accordion>

  <Accordion title="Performance Issues">
    For better performance on slower connections:

    * **Remmina**: Reduce color depth to "High Color (16 bpp)"
    * **xfreerdp**: Add `/compression /network:modem` to your command
    * Disable desktop wallpaper and visual effects in Windows
  </Accordion>
</AccordionGroup>