Polyaxon makes it easy to start a VSCode session on your GPU cluster.


Polyaxon schedules VSCode sessions based on this component.

Create a new session using the CLI

polyaxon run --hub vscode

To provide a specific tag:

polyaxon run --hub vscode:TAG_VERSION

To start the session on a different project

polyaxon run --hub vscode -p project-name

Viewing the service

Go to the UI under the service tab:

polyaxon ops dashboard [-uid] [-p]

Or to get to the service directly:

polyaxon ops service [-uid] [-p]

Or to get the service in full-screen mode:

polyaxon ops service --external [-uid] [-p]
  • Light theme (Polyaxon and VSCode)


  • Dark theme (Polyaxon and VSCode)


Queues, presets, node scheduling, custom resources, …

You can provide more information before scheduling the service, like the queue, presets, …

polyaxon run --hub vscode -q agent-name/queue-name --presets preset-name1,preset-name2

Local preset

polyaxon run --hub vscode -f path/to/preset.yaml

You can also provide a full operation manifest to customize the environment section, node selector, connections, initializers, resources requirements, …

version: 1.1
kind: operation
hubRef: vscode
    - git: ...
  connections: [...]
        memory: 300Mi

Forking and customizing the component

If you need to expose the vscode component with your predefined configuration without requiring end-users to create operations, we suggest that you clone the component and customize it.

On Polyaxon CE, you will need to create a new .yaml file where you will host the content of the component, and users can either start new sessions using:

  • polyaxon run -f my-custom-vscode.yaml
  • polyaxon run --url https://path/to/my-custom-vscode.yaml

On Polyaxon Cloud or Polyaxon EE, you just need to add a new component hub. The end users will need to run with org-name/vscode instead of vscode:

polyaxon run --hub acme/vscode

Note: In order to use acme/vscode without :tag you need to name the version latest.


All vscode versions can be found on the component hub

polyaxon hub ls -c vscode