Skip to content

Connecting to Workspaces

Once you have a Workspace up and running, you can connect to it directly from the MemVerge AI platform. This process opens the Workspace’s user interface—typically a Jupyter Notebook or VS Code session—in a new browser tab.

Steps to Connect

  1. Open the Workspaces Dashboard

    • In the left navigation menu, select Workspaces.
    • A list of all existing Workspaces appears, each with information about its name, status, project, and available actions.

    Workspace Card

  2. Locate the Workspace

    • Find the Workspace you want to interact with (e.g., jupyter-data-lab or vscode-dev-env).
    • Ensure the Workspace status is Running or Ready before attempting to connect.

  3. Click “Connect”

    • Under the Actions column (or within the Workspace card), choose Connect.
    • The platform opens a new browser tab or window containing the Workspace’s environment.

  4. Authenticate if Required

    • Depending on the Workspace’s configuration, you may be prompted to enter credentials or token-based authentication.
    • Once authenticated, you can access the full interface (Jupyter Notebook, VS Code, etc.).

What to Expect in the Workspace

  • Jupyter Notebook:

    • A web-based interactive environment where you can create and run Python (or other kernel-based) notebooks.
    • Includes features for data visualization, markdown notes, and code execution.

  • VS Code:

    • A web-based version of Visual Studio Code offering a familiar editor UI, integrated terminal, and debugging capabilities.
    • You can install additional extensions or configure language servers for your development needs.

Troubleshooting Connection Issues

  1. Workspace Not Ready

    • If the Workspace shows Pending or Initializing, wait until it transitions to Running or Ready.
    • Refresh the page or check the Conditions tab to see if there are any errors preventing the Workspace from starting.

  2. Browser Pop-Up Blockers

    • Some browsers may block new tabs automatically. Check for a pop-up blocker warning and allow the page to open a new tab.

  3. Timeout or Network Errors

    • If the connection times out, verify your network connectivity or VPN settings.
    • Confirm that the platform’s ingress or load balancer is properly configured.

  4. Workspace Credentials

    • If a login prompt fails, verify your user credentials or token. For Jupyter, ensure the correct token is entered.
    • For VS Code, check if there’s a username/password required.

Best Practices

  • Data Persistence: Save important code and data to attached volumes. This ensures your work remains intact if the session ends.
  • Resource Monitoring: Keep an eye on CPU, memory, and GPU usage within the Workspace. Consider resizing or stopping the Workspace if resources are under- or over-utilized.
  • Version Control: Use Git or another version-control system within the Workspace to track changes and collaborate with teammates.