How To Access a GPU Container
Connect to a running GPU container to execute commands and manage your environment. The shell session runs over Hyperswarm SSH — a peer-to-peer tunnel between the CLI and the agent inside the VM. Once connected, you can install dependencies, run training scripts, and interact with your container.
Need to create a container first? See How to Create a GPU Container.
Prerequisites
- Running GPU container
- CosmicAC CLI installed (see Installation guide)
Login (Optional)
If not already authenticated:
npx cosmicac loginThis opens your browser for authentication. If the browser doesn't open automatically, copy the URL from the terminal and paste it into your browser. Complete the login to continue.
Open a shell session
npx cosmicac jobs shell <jobId> <containerNumber>Replace:
<jobId>— Your job ID.<containerNumber>— Target container number.
Type exit and press Enter to close the shell session.
What's next?
- CLI Commands: Job Management — Full reference for all job commands with output examples.
- System Components — How the CLI connects to the Hyperswarm agent running inside the VM.
- Overview: GPU Containers — Conceptual explanation of the shell access model.