Build and Install¶
Nav2 and its dependencies are released as binaries. You may install it via the following to get the latest stable released version:
sudo apt install ros-<distro>-navigation2 ros-<distro>-nav2-bringup ros-<distro>-turtlebot3*
(For Ubuntu 20.04 use this command as the parsing of wildcards have been changed:
sudo apt install ros-<distro>-navigation2 ros-<distro>-nav2-bringup '~ros-<distro>-turtlebot3-.*'
There are 3 ways to build Nav2.
Building for a specific released distribution (e.g.
foxy), build Nav2 on main branch using a quickstart setup script, or building main branch manually.
Quickstart Build Main¶
Install all ROS 2 dependencies from the ROS 2 Installation page. Ensure there are no ROS environment variables set in your terminal or .bashrc file before taking the steps below.*
mkdir <directory_for_workspaces> cd <directory_for_workspaces> wget https://raw.githubusercontent.com/ros-planning/navigation2/main/tools/initial_ros_setup.sh chmod a+x initial_ros_setup.sh ./initial_ros_setup.sh
Summary of what’s being done
initial_ros_setup.sh script downloads three ROS workspaces and then builds them in the correct order. The three workspaces are:
- ROS 2 release: This is the latest ROS 2 release as defined by the repos file found here
- ROS 2 dependencies: This is a set of ROS 2 packages that aren’t included in the ROS 2 release yet. However, you need them to be able to build Nav2. This also includes packages that are part of the ROS 2 release where Nav2 uses a different version.
- Nav2: This repository.
After all the workspaces are downloaded, run the navigation2/tools/build_all.sh script. build_all.sh builds each repo in the order listed above using the colcon build –symlink-install command.
The initial_ros_setup.sh accepts the following options:
--no-ros2This skips downloading and building the ROS 2 release. Instead it uses the binary packages and
--download-onlyThis skips the build steps
There are 2 options for docker with Nav2: building a container and using the DockerHub container.
Building Docker Container¶
To build an image from the Dockerfile in the Nav2 folder: First, clone the repo to your local system (or see Building the source above)
sudo docker build -t nav2/latest .
If proxies are needed:
sudo docker build -t nav2/latest --build-arg http_proxy=http://proxy.my.com:### --build-arg https_proxy=http://proxy.my.com:### .
Note: You may also need to configure your docker for DNS to work. See article here for details: https://development.robinwinslow.uk/2016/06/23/fix-docker-networking-dns/
Using DockerHub Container¶
We allow for you to pull the latest docker image from the main branch at any time. As new releases and tags are made, docker containers on docker hub will be versioned as well to chose from.
sudo docker pull rosplanning/navigation2:main.release
doxygen in the root of the Nav2 repository.
It will generate a
/doc/* directory containing the documentation.
The documentation entrypoint in a browser is index.html.