Before installing yb-voyager, ensure that you have the Docker runtime installed on your machine.

  1. Pull the docker image from YugabyteDB's docker hub (Pull the version from docker.io) as follows:

    docker pull yugabytedb/yb-voyager
    
  2. Download the script to run yb-voyager using the docker image from yb-voyager's GitHub repository, and move it to your machine's bin directory using the following commands:

    wget -O ./yb-voyager https://raw.githubusercontent.com/yugabyte/yb-voyager/main/docker/yb-voyager-docker && chmod +x ./yb-voyager && sudo mv yb-voyager /usr/local/bin/yb-voyager
    

    Use yb-voyager docker script without sudo to run Voyager commands. To do this you need to reconfigure docker on your system to run without sudo. Refer to Manage Docker as a non-root user in the Docker documentation.
  3. Check that yb-voyager is installed using the following command:

    yb-voyager version