Custom Docker Containers

Run Docker and Docker Compose workloads with GPU access on your Brev instance for reproducible, isolated development.

Creating an Instance with Containers

You can configure containers when creating a new instance through the Brev console.

Container Mode Options

When you select Container Mode, choose from:

Docker Compose Mode Options

When you select Docker Compose Mode, provide your configuration through:

• Upload: Upload a local docker-compose.yml file
• URL: Provide a GitHub or GitLab URL pointing to a docker-compose.yml file

Running Containers with GPU (CLI)

Brev instances have Docker and NVIDIA Container Toolkit preinstalled. Use the --gpus all flag to enable GPU access:

$
# Run PyTorch container with GPU
$
docker run --gpus all -it nvcr.io/nvidia/pytorch:24.01-py3 python -c "import torch; print(torch.cuda.is_available())"
$
$
# Run with port mapping
$
docker run --gpus all -p 8888:8888 -it nvcr.io/nvidia/pytorch:24.01-py3

Docker Compose with GPU

For multi-container applications, use Docker Compose with GPU support:

1
# docker-compose.yml
2
services:
3
  app:
4
    image: nvcr.io/nvidia/pytorch:24.01-py3
5
    deploy:
6
      resources:
7
        reservations:
8
          devices:
9
            - driver: nvidia
10
              count: all
11
              capabilities: [gpu]
12
    ports:
13
      - "8888:8888"
14
    volumes:
15
      - ./:/workspace

$
# Start the stack
$
docker compose up -d
$
$
# View logs
$
docker compose logs -f

NVIDIA NGC Images

NVIDIA provides optimized containers for common AI/ML frameworks:

What’s Next