lightning/dockers
Shashwat Agrawal 574a951601
docs: updated broken links (#16191)
Co-authored-by: Shashwat <shashwat>
Fixes https://github.com/Lightning-AI/lightning/issues/16186
2022-12-24 04:18:58 +01:00
..
base-cuda ci: adjust version in all requirements (#16100) 2022-12-22 06:21:52 +00:00
base-ipu Drop PyTorch 1.9 support (#15347) 2022-11-10 08:59:13 -05:00
base-xla CI: parameterize TPU tests (#15876) 2022-12-06 17:00:15 +00:00
ci-runner-hpu Upgrade to HPU release 1.7.1 (#15956) 2022-12-08 11:43:22 +00:00
ci-runner-ipu Drop PyTorch 1.9 support (#15347) 2022-11-10 08:59:13 -05:00
nvidia PKG: distribute single semver (#15374) 2022-11-12 15:36:36 +00:00
release ci: adjust version in all requirements (#16100) 2022-12-22 06:21:52 +00:00
README.md docs: updated broken links (#16191) 2022-12-24 04:18:58 +01:00

README.md

Docker images

Build images from Dockerfiles

You can build it on your own, note it takes lots of time, be prepared.

git clone https://github.com/Lightning-AI/lightning.git

# build with the default arguments
docker image build -t pytorch-lightning:latest -f dockers/base-cuda/Dockerfile .

# build with specific arguments
docker image build -t pytorch-lightning:base-cuda-py3.9-torch1.12-cuda11.6.1 -f dockers/base-cuda/Dockerfile --build-arg PYTHON_VERSION=3.9 --build-arg PYTORCH_VERSION=1.12 --build-arg CUDA_VERSION=11.6.1 .

To run your docker use

docker image list
docker run --rm -it pytorch-lightning:latest bash

and if you do not need it anymore, just clean it:

docker image list
docker image rm pytorch-lightning:latest

Run docker image with GPUs

To run docker image with access to your GPUs, you need to install

# Add the package repositories
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list

sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
sudo systemctl restart docker

and later run the docker image with --gpus all. For example,

docker run --rm -it --gpus all pytorchlightning/pytorch_lightning:base-cuda-py3.9-torch1.12-cuda11.6.1

Run Jupyter server

  1. Build the docker image:
    docker image build -t pytorch-lightning:v1.6.5 -f dockers/nvidia/Dockerfile --build-arg LIGHTNING_VERSION=1.6.5 .
    
  2. start the server and map ports:
    docker run --rm -it --gpus=all -p 8888:8888 pytorch-lightning:v1.6.5
    
  3. Connect in local browser:
    • copy the generated path e.g. http://hostname:8888/?token=0719fa7e1729778b0cec363541a608d5003e26d4910983c6
    • replace the hostname by localhost