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

# Enable VNC on Your VPS

> Turn VNC on or off from the EDBB Control Panel so you can reach the console via Open Console or a desktop VNC client.

# Enable VNC for Console Access

<Info>
  VNC provides a screen-and-keyboard view of your VPS even when SSH or RDP is unavailable. Enable it only while you need interactive console access and turn it off afterward.
</Info>

***

## What You’ll Need

<CardGroup cols={3}>
  <Card title="🔐 Control Panel Access">
    Sign in to the <a href="https://my.edbb.com/clientarea.php" target="_blank">EDBB Control Panel</a> and open the VPS you want to manage.
  </Card>

  <Card title="🕒 Maintenance Window">
    Plan a brief window—it’s best to enable VNC only when you’re actively using it.
  </Card>

  <Card title="🖥️ Modern Browser or VNC Client">
    You can use the built-in <strong>Open Console</strong> button (browser-based) or a desktop VNC client such as RealVNC/TightVNC.
  </Card>
</CardGroup>

***

## Step 1 – Toggle VNC

<Steps>
  <Step title="Open the quick action menu">
    In the service Control Panel, locate the quick action panel. Click the arrow next to the red <strong>VNC Off</strong> button and choose <strong>Enable VNC</strong>.

    <img src="https://mintcdn.com/edbackboneco/zYSrJ2bFWE_Sezdg/assets/enable-vnc.png?fit=max&auto=format&n=zYSrJ2bFWE_Sezdg&q=85&s=54c4f4dbcb1e8b8d7a17412e4aaa3e7a" alt="VNC access controls in the quick action panel" width="382" height="378" data-path="assets/enable-vnc.png" />
  </Step>

  <Step title="Wait for VNC to turn on">
    The button turns green and displays <strong>VNC On</strong>. The panel now shows the VNC hostname and password for desktop clients.
  </Step>
</Steps>

<img src="https://mintcdn.com/edbackboneco/zYSrJ2bFWE_Sezdg/assets/VNC-info.png?fit=max&auto=format&n=zYSrJ2bFWE_Sezdg&q=85&s=918c11649a19d64992beb46dd12b0064" alt="VNC access controls in the quick action panel" width="382" height="594" data-path="assets/VNC-info.png" />

***

## Step 2 – Open the Console

* Click <strong>Open Console</strong> to launch the browser-based console. No password is required for this view—just click inside the window to capture keyboard and mouse input.
* Prefer a desktop client? Copy the VNC hostname and password shown in the panel and connect using RealVNC, TightVNC, or any compatible viewer.

## <img src="https://mintcdn.com/edbackboneco/S2gdrGxvpzq5uZa3/assets/vnc-console.png?fit=max&auto=format&n=S2gdrGxvpzq5uZa3&q=85&s=b465889b251f50fe629e40062ce5722b" alt="Open console" width="382" height="594" data-path="assets/vnc-console.png" />

## Step 3 – Disable VNC When Finished

<Steps>
  <Step title="Toggle VNC off">
    Open the dropdown beside <strong>VNC On</strong> and choose <strong>Disable VNC</strong> once you’re done troubleshooting or installing software.
  </Step>

  <Step title="Confirm access paths">
    After disabling VNC, reconnect using SSH or RDP as normal. The console will no longer be accessible until you enable VNC again.
  </Step>
</Steps>

<Callout type="warning">
  Leaving VNC enabled exposes an additional attack surface. Disable it when you’re finished to keep the VPS secure.
</Callout>

You can now confidently toggle VNC on and off whenever you need direct console access to your EDBB VPS.

## Desktop VNC Client Instructions

Connect to your server using your preferred **VNC Viewer** (for example: RealVNC, TightVNC, or UltraVNC).

1. **Open your VNC Client** on your computer.
2. **Enter the VNC Server address and port** shown in the **Information card** (e.g. `your-server-ip:5901`).
3. **Use the VNC password** provided in **Step 1 – Start VNC**.
4. Click **Connect** to establish the session.

💡 *Tip:* If the connection fails, make sure the Rescue System or VPS is running.