Install on Linux via Docker¶

1. Pull PaddlePaddle image¶

For domestic users, when downloading docker is slow due to network problems, you can use the mirror provided by Baidu:

• CPU version of PaddlePaddle：

  docker pull registry.baidubce.com/paddlepaddle/paddle:3.0.0b1
  

• CPU version of PaddlePaddle, and the image is pre-installed with jupyter：

  docker pull registry.baidubce.com/paddlepaddle/paddle:3.0.0b1-jupyter
  

• GPU version of PaddlePaddle(Latest version of gpu image is recommended， and make sure NVIDIA Container Toolkit is installed successfully)：

  docker pull registry.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda12.3-cudnn9.0-trt8.6
  

  docker pull registry.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda11.8-cudnn8.6-trt8.5
  

If your machine is not in mainland China, you can pull the image directly from DockerHub:

• CPU version of PaddlePaddle：

  docker pull paddlepaddle/paddle:3.0.0b1
  

• CPU version of PaddlePaddle, and the image is pre-installed with jupyter：

  docker pull paddlepaddle/paddle:3.0.0b1-jupyter
  

• GPU version of PaddlePaddle(Latest version of gpu image is recommended， and make sure NVIDIA Container Toolkit is installed successfully)：

  docker pull paddlepaddle/paddle:3.0.0b1-gpu-cuda12.3-cudnn9.0-trt8.6
  

  docker pull paddlepaddle/paddle:3.0.0b1-gpu-cuda11.8-cudnn8.6-trt8.5
  

You can see DockerHub to get more images.

2. Build and enter Docker container¶

• Use CPU version of PaddlePaddle：

  docker run --name paddle_docker -it -v $PWD:/paddle registry.baidubce.com/paddlepaddle/paddle:3.0.0b1 /bin/bash
  

  • --name paddle_docker: set name of Docker, paddle_docker is name of docker you set;

  • -it: The parameter indicates that the container has been operated interactively with the local machine;

  • -v $PWD:/paddle: Specifies to mount the current path of the host (PWD variable in Linux will expand to the absolute path of the current path) to the /paddle directory inside the container;

  • registry.baidubce.com/paddlepaddle/paddle:3.0.0b1: Specify the name of the image to be used. You can view it through the ‘docker images’ command. /bin/Bash is the command to be executed in Docker

• Use GPU version of PaddlePaddle：

  docker run --gpus all --name paddle_docker -v $PWD:/paddle --network=host -it registry.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda12.3-cudnn9.0-trt8.6 /bin/bash
  

  • --gpus all: gpu resources can be used in Docker container;

  • --name paddle_docker: set name of Docker, paddle_docker is name of docker you set;

  • -it: The parameter indicates that the container has been operated interactively with the local machine;

  • -v $PWD:/paddle: Specifies to mount the current path of the host (PWD variable in Linux will expand to the absolute path of the current path) to the /paddle directory inside the container;

  • registry.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda12.3-cudnn9.0-trt8.6: Specify the name of the image to be used. You can view it through the ‘docker images’ command. /bin/Bash is the command to be executed in Docker

• Use CPU version of PaddlePaddle with jupyter：

  mkdir ./jupyter_docker
  

  chmod 777 ./jupyter_docker
  

  cd ./jupyter_docker
  

  docker run -p 80:80 --rm --env USER_PASSWD="password you set" -v $PWD:/home/paddle registry.baidubce.com/paddlepaddle/paddle:3.0.0b1-jupyter
  

  • --rm: Delete the container after closing it;

  • --env USER_PASSWD="password you set": Set the login password for jupyter, password you set is the password you set;

  • -v $PWD:/home/paddle: Specifies to mount the current path (the PWD variable will be expanded to the absolute path of the current path) to the /home/paddle directory inside the container;

  • registry.baidubce.com/paddlepaddle/paddle:3.0.0b1-jupyter: Specify the name of the image to be used, you can view it through the docker images command

Now you have successfully used Docker to install PaddlePaddle. For more information about using Docker, seeDocker official documents