Before installing yb-voyager, ensure that you have the Docker runtime installed on your machine.
-
Pull the docker image from YugabyteDB's docker hub (Pull the version from docker.io) as follows:
docker pull yugabytedb/yb-voyager
-
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 withoutsudo
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. -
Check that yb-voyager is installed using the following command:
yb-voyager version