https://github.com/rahji/makecode-cpx-docker
A Docker config for makecode.adafruit.com for Circuit Playground Express
https://github.com/rahji/makecode-cpx-docker
Last synced: 2 months ago
JSON representation
A Docker config for makecode.adafruit.com for Circuit Playground Express
- Host: GitHub
- URL: https://github.com/rahji/makecode-cpx-docker
- Owner: rahji
- License: gpl-3.0
- Created: 2024-03-10T05:02:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-14T03:45:29.000Z (about 1 year ago)
- Last Synced: 2025-02-06T02:51:23.733Z (4 months ago)
- Language: Dockerfile
- Size: 20.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# makecode-cpx-docker
A Docker config for makecode.adafruit.com for Circuit Playground Express
This is a locally-hosted version of the makecode web programming tool for the Circuit Playground Express.
In theory, I will be able to conduct a CPX workshop in a location with no internet, by running this docker container from my laptop and having participants browse to `http://MYIPADDRESS:3232`
## Installation
Download [Docker Desktop](https://www.docker.com/products/docker-desktop/). If you're using Windows, I'd suggest following [these instructions for making Docker Desktop work with WSL2](https://docs.docker.com/desktop/wsl/).
The [Docker image is DockerHub](https://hub.docker.com/r/robduarte/makecode-cpx). You can pull it from there to your computer with this command:
```bash
docker pull robduarte/makecode-cpx
```
## Starting the Server
Run the container like this: `docker run -p 3232:3232 -p 3233:3233 robduarte/makecode-cpx`
It will take a few minutes for the server to start. Once the server has been successfully started, part of the process appears to start again, which I haven't figured out. Because of this, you will need to scroll up a bit to find the URL in the text being logged to the console. The URL has a hostname of `0.0.0.0` but you'll need to change that to something else as described below.
### Viewing MakeCode Locally
To access the MakeCode website from the same machine that is running the Docker container, you'll need to change the `0.0.0.0` part of the URL to the "localhost" address of `127.0.0.1`
### Viewing MakeCode as a Workshop Participant
I'm planning to use this to give workshop participants access to the MakeCode web-based tool even though there will be no Internet access at the workshop location. I will bring a wifi router that I have hanging around and ask everyone to connect to that router. Although they won't have Internet access, their computer should be able to contact my laptop (which is running the Docker container). In this case, I will give participants the URL from above, but I will replace `0.0.0.0` with my accessible WiFi IP address.