Skip to main content

​
Web terminal connection

The web terminal offers a convenient, browser-based method to quickly connect to your Bnode and run commands. However, it’s not recommended for long-running processes, such as training an LLM, as the connection might not be as stable or persistent as a direct SSH connection. The availability of the web terminal depends on the Bnode’s template. To connect using the web terminal:
  1. Navigate to the Bnodes page in the Brightnode console.
  2. Expand the desired Bnode and select Connect.
  3. If your web terminal is Stopped, click Start.
    If clicking Start does nothing, try refreshing the page.
  4. Click Open Web Terminal to open a new tab in your browser with a web terminal session.

​
JupyterLab connection

JupyterLab provides an interactive, web-based environment for running code, managing files, and performing data analysis. Many Brightnode templates, especially those geared towards machine learning and data science, come with JupyterLab pre-configured and accessible via HTTP. To connect to JupyterLab (if it’s available on your Bnode):
  1. Deploy your Bnode, ensuring that the template is configured to run JupyterLab. Official Brightnode templates like “Brightnode Pytorch” are usually compatible.
  2. Once the Bnode is running, navigate to the Bnodes page in the Brightnode console.
  3. Find the Bnode you created and click the Connect button. If it’s grayed out, your Bnode hasn’t finished starting up yet.
  4. In the window that opens, under HTTP Services, look for a link to Jupyter Lab (or a similarly named service on the configured HTTP port, often 8888). Click this link to open the JupyterLab workspace in your browser.
    If the JupyterLab tab displays a blank page for more than a minute or two, try restarting the Bnode and opening it again.
  5. Once in JupyterLab, you can create new notebooks (e.g., under Notebook, select Python 3 (ipykernel)), upload files, and run code interactively.

​
SSH terminal connection

Connecting to a Bnode via an SSH (Secure Shell) terminal provides a secure and reliable method for interacting with your instance. To establish an SSH connection, you’ll need an SSH client installed on your local machine. The exact command will vary slightly depending on whether you’re using the basic proxy connection or a direct connection to a public IP. To learn more, see Connect to a Bnode with SSH.

​
Connect to VSCode or Cursor

For a more integrated development experience, you can connect directly to your Bnode instance through Visual Studio Code (VSCode) or Cursor. This allows you to work within your Bnode’s volume directory as if the files were stored on your local machine, leveraging VSCode’s or Cursor’s powerful editing and debugging features. For a step-by-step guide, see Connect to a Bnode with VSCode or Cursor.