# docker-ros-jupyter

**Repository Path**: mirrors_lepy/docker-ros-jupyter

## Basic Information

- **Project Name**: docker-ros-jupyter
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-02-23
- **Last Updated**: 2023-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ROS Jupyter Notebook with ROS in Docker [![](https://img.shields.io/docker/pulls/frankjoshua/ros-jupyter)](https://hub.docker.com/r/frankjoshua/ros-jupyter) [![CI](https://github.com/frankjoshua/docker-ros-jupyter/workflows/CI/badge.svg)](https://github.com/frankjoshua/docker-ros-jupyter/actions)

## Description

Runs a Jupyter Notebook with ROS in a Docker container. Probably need --network="host" because ROS uses ephemeral ports.

This container will also start a ROS master and TFT Web Republisher. I'm currently looking for a way to make that optional.

## Example

```
docker run -it \
    --env="ROS_IP=$ROS_IP" \
    --env="ROS_MASTER_URI=$ROS_MASTER_URI" \
    -v "$PWD:/home/jovyan/ros-jupyter" \
    --network="host" \
    frankjoshua/ros-jupyter
```

## Building

Use [build.sh](build.sh) to build the docker containers.

<br>Local builds are as follows:

```
./build.sh -t frankjoshua/ros-jupyter -l
```

## Testing

Github Actions expects the DOCKERHUB_USERNAME and DOCKERHUB_TOKEN variables to be set in your environment.

## License

Apache 2.0

## Author Information

Joshua Frank [@frankjoshua77](https://www.twitter.com/@frankjoshua77)
<br>
[http://roboticsascode.com](http://roboticsascode.com)