cutter/docker/README.md

# Docker Configuration for Cutter

These files provide an easy way to deploy *Cutter* in a Docker container. After additional configuration you may want to apply to the `Makefile`, execute `make run`. By default, the *Cutter* image on [Docker Hub](https://hub.docker.com/r/radareorg/cutter/) will be used along with additional UID, capability, X and mount settings:

- Xauthority settings which avoid using potentially insecure `xhost` directives. The settings have been adapted from [this post](https://stackoverflow.com/questions/16296753/can-you-run-gui-apps-in-a-docker-container/25280523#25280523).
- Mount directives to mount a shared folder and radare2 configuration files.
- The UID and GID of the user executing `make run` will also be used for the internal container user to avoid permission problems when sharing files.

## Mounting and Using a Specific Binary

The `Makefile` allows mounting a single binary file as read-only, which will also be used as an input for *Cutter*. To use this feature, execute `make run BINARY=/absolote/path/to/binary`.

## Additional Notes

- The internal container user doesn't use superuser privileges and is called `r2`.
- To check for more options of the `Makefile`, execute `make`.
Removed docker.sh and added new docker related files into docker folder (#535) * Removed docker.sh and added new docker related files into docker folder 2018-06-25 09:43:59 +00:00			`# Docker Configuration for Cutter`

Docker: Add UID/GID mapping, Refactoring (#557) * docker/Dockerfile: Reduce layer count, restructure * Docker: Add UID/GID mapping 2018-06-30 11:50:05 +00:00			These files provide an easy way to deploy Cutter in a Docker container. After additional configuration you may want to apply to the `Makefile`, execute `make run`. By default, the Cutter image on [Docker Hub](https://hub.docker.com/r/radareorg/cutter/) will be used along with additional UID, capability, X and mount settings:
Removed docker.sh and added new docker related files into docker folder (#535) * Removed docker.sh and added new docker related files into docker folder 2018-06-25 09:43:59 +00:00
Docker: Fix error upon running the container, Add Xauth settings, Add feature to load a host binary as read-only (#556) 2018-06-29 19:16:51 +00:00			- Xauthority settings which avoid using potentially insecure `xhost` directives. The settings have been adapted from [this post](https://stackoverflow.com/questions/16296753/can-you-run-gui-apps-in-a-docker-container/25280523#25280523).
			`- Mount directives to mount a shared folder and radare2 configuration files.`
Docker: Add UID/GID mapping, Refactoring (#557) * docker/Dockerfile: Reduce layer count, restructure * Docker: Add UID/GID mapping 2018-06-30 11:50:05 +00:00			- The UID and GID of the user executing `make run` will also be used for the internal container user to avoid permission problems when sharing files.
Removed docker.sh and added new docker related files into docker folder (#535) * Removed docker.sh and added new docker related files into docker folder 2018-06-25 09:43:59 +00:00
Docker: Fix error upon running the container, Add Xauth settings, Add feature to load a host binary as read-only (#556) 2018-06-29 19:16:51 +00:00			`## Mounting and Using a Specific Binary`

			The `Makefile` allows mounting a single binary file as read-only, which will also be used as an input for Cutter. To use this feature, execute `make run BINARY=/absolote/path/to/binary`.

			`## Additional Notes`

			- The internal container user doesn't use superuser privileges and is called `r2`.
			- To check for more options of the `Makefile`, execute `make`.