https://github.com/rozek/docker-red
run RED scripts in a Docker Container
https://github.com/rozek/docker-red
Last synced: about 1 month ago
JSON representation
run RED scripts in a Docker Container
- Host: GitHub
- URL: https://github.com/rozek/docker-red
- Owner: rozek
- License: mit
- Created: 2023-08-01T10:11:08.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-03T03:29:23.000Z (almost 2 years ago)
- Last Synced: 2025-01-29T20:29:50.633Z (3 months ago)
- Language: Dockerfile
- Size: 19.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-red #
runs RED (and Rebol) scripts in a Docker Container (not only) on a modern Mac
[RED](https://www.red-lang.org/p/about.html) (and [Rebol](http://www.rebol.com/)) scripts do not run under macOS Catalina and newer since 32-bit applications are no longer supported.
If you still want to experiment with Rebol and/or RED, you will have to start a [Docker](https://www.docker.com/) container and either use a shell to run CLI scripts or use "X11 forwarding" for GUI scripts.
This repository basically contains a Dockerfile to build a Docker image for CLI and GUI scripts plus instructions for setting up a Mac in order to display RED/Rebol GUIs. The Dockerfile is based on a [similar project](https://codeberg.org/vazub/red-docker), but has been modified to run all kinds of RED and Rebol scripts - additionally, the instructions to configure macOS have been modernized and simplified.
## Build a Docker Image ##
In order to build and run Docker images you must have Docker installed - for most people, installing the [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the best way to do so.
Then follow the steps shown below:
1. clone this repository: either use
`git clone https://github.com/rozek/docker-red`
or [download a ZIP archive](https://github.com/rozek/docker-red/archive/refs/heads/main.zip) with this repository and unpack it
2. navigate to the root folder of this repository:
`cd docker-red`
3. build the Docker image using
`docker build -t docker-red .`
## Run RED/Rebol CLI Scripts ##
You are now ready to run CLI scripts. Simply start the container built before using
```
docker run --rm --platform=linux/386 -v .:/transfer -it docker-red
```
from the macOS Terminal and you will get a RED prompt.
If you prefer Rebol itself, just run
```
docker run --rm --platform=linux/386 -v .:/transfer -it docker-red /bin/rebol
```
instead.
## Sharing a Host Folder with the Docker Container ##
The Docker image has been prepared to share a local (host) folder with the container - either for copying files into the container or vice-versa (or both).
Simply navigate to the local folder you want to share
```
cd
```
and run the Docker image as shown above.
Alternatively, you may also change the `-v .:/transfer` part of the Docker commands shown above to
```
-v :/transfer
```
and start the Docker container from anywhere.
## Prepare a Mac for X11 Display Forwarding ##
MacOS cannot natively display GUIs created inside a Docker container - you need to install XQuartz for that purpose. Simply follow steps 1...7 from [another guide](https://gist.github.com/sorny/969fe55d85c9b0035b0109a31cbcb088) **but do not forget to restart your Mac!**
## Run RED/Rebol GUI Scripts ##
You are now ready to run GUI scripts as well:
```
open -a XQuartz \
&& xhost +localhost \
&& docker run --rm --platform=linux/386 -v .:/transfer -e DISPLAY=host.docker.internal:0 \
-it docker-red /bin/red-view
```
starts `red-view` and
```
open -a XQuartz \
&& xhost +localhost \
&& docker run --rm --platform=linux/386 -v .:/transfer -e DISPLAY=host.docker.internal:0 \
-it docker-red /bin/rebol-view
```
does the same for Rebol and opens the famous Rebol Viewtop.
If you want to share a local folder with a Docker container running a GUI script, simply choose one of the approaches described above.
## License ##
[MIT License](LICENSE.md)