Skip to main content

Create Pod

The Create Pod page allows you to configure and deploy a new compute pod with GPU resources.

Pod Configuration​

Basic Settings​

Pod Name

  • Default: "Your Pod"
  • Enter a custom name to identify your pod

Template Selection​

The Template Selection section allows you to choose the environment configuration (template) that will be used to create your pod. A template defines the base Docker image, software stack, and environment settings for your GPU container. Selecting the right template ensures your pod has the correct libraries, frameworks, and dependencies for your workload.

How Template Selection Works:

  • You can browse from a list of available templates, including official and custom templates.
  • Each template specifies a Docker image, version, and may include labels to help you identify its popularity or your usage history.
  • Selecting a template determines the software environment (e.g., Python version, CUDA version, pre-installed libraries) your pod will have when it starts.

Example:

Suppose you want to run PyTorch with CUDA support. You might select the following template:

Pytorch (Cuda) - daturaal/pytorch

  • Image: 2.70-py3.12-cuda12.8.0-devel-ubuntu24.04
  • Labels:
    • Previously used: This label indicates you have used this template in a previous pod deployment.
    • Most popular: This label means the template is commonly used and is cached as the default for the selected node.

What this means:
By choosing this template, your pod will be provisioned with PyTorch installed, CUDA 12.8.0 support, and based on Ubuntu 24.04. This is suitable for deep learning tasks requiring GPU acceleration.

You can select other templates as needed, depending on your project requirements (e.g., TensorFlow, custom images, etc.).

SSH Access​

This section allows you to configure how you will securely connect to your pod using SSH (Secure Shell).

SSH Key Configuration
SSH keys are used to authenticate your access to the pod without needing a password. Here’s how the options work:

  • Current Selection: Shows the SSH key (e.g., "waris") that will be installed on your pod for access. You can remove it if you want to use a different key.
  • Dropdown ("Choose SSH Key"): Lets you select from your list of previously added SSH keys.
  • Add SSH Key: Use this button to add a new SSH key if you haven’t uploaded one yet or want to use a different key.

In summary, this section ensures that only you (or someone with your SSH key) can access the pod after it is deployed, providing secure and convenient remote access.

Storage​

External Volume Configuration

  • Volume Selection: Use the "Choose Volume" dropdown to select from your available external storage volumes.
  • Add Volume: Click the button to attach additional external storage volumes to your pod.

For more details about how volumes work in Lium, see the Volumes documentation.

Restore Options
The Restore option allows you to restore a backup immediately when your pod is deployed. This is useful if you want your new pod to start with data from a previous backup.

  • Volume Path: /root (the directory where the backup will be restored)
  • Backup: Option to "Enter backup ID directly"
  • Select Backup: Button to choose from your existing backups

For more details on how restores work, see the Restore documentation.

Pod Summary​

This section provides an overview of all the key settings and resources you have chosen for your pod before deployment. The summary panel helps you quickly review your hardware configuration (such as CPU, memory, disk, and GPU), network details, geographic location, and estimated pricing. Reviewing this summary ensures that your pod will be provisioned exactly as intended and allows you to confirm your selections before finalizing the deployment.

Advanced Options​

Agent SSH Key​

Lium automatically adds an agent SSH key to your pod to enable features like the web terminal and to monitor pod health.

  • Skip agent SSH key: Check this box if you do not want the agent SSH key added.

Note:
If you skip the agent SSH key:

  • The web terminal will be disabled.
  • Lium cannot check SSH connectivity or monitor your pod.
  • Connection issues cannot be verified or reported to the GPU provider.

Recommendation:
Keep the agent SSH key enabled unless you have a specific reason to disable it.

Deployment​

Once all configurations are set, click the Deploy button to create and start your pod. The pod will be provisioned with the selected hardware, template, and access configurations.

Next Steps​

After deployment:

  1. Connect to your pod via SSH using your configured key
  2. Access your development environment
  3. Monitor pod performance and costs through the dashboard
  4. Manage volumes and backups as needed
tip

Make sure your SSH key is properly configured before deployment to ensure secure access to your pod.