commit ae520ca0166ec2c6d0fd66fa75313b6c845717f4 Author: MassiveBox Date: Sat Aug 20 19:41:38 2022 +0200 First commit diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..f740607 --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +mount +project.geany diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..0487742 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,20 @@ +FROM debian:bullseye + +RUN apt-get update; \ + apt-get upgrade -y; \ + apt-get install git make gcc file g++ wget cpio python unzip rsync bc bzip2 mercurial squashfs-tools -y; \ + git clone https://github.com/retrofw/buildroot-retrofw-2.3.git buildroot; \ + mkdir mount + +WORKDIR buildroot + +RUN git checkout remotes/origin/2021.11.x; \ + make RetroFW_defconfig BR2_EXTERNAL=board/retrofw; \ + env FORCE_UNSAFE_CONFIGURE=1 make toolchain sdl sdl_image sdl_mixer sdl_sound; \ + echo 'export PATH=/buildroot/output/host/bin:/buildroot/output/host/mipsel-RetroFW-linux-uclibc/sysroot/usr/bin:$PATH' >> ~/.bashrc + +RUN make sdl_ttf + +WORKDIR /mount + +ENTRYPOINT echo "Container started, now execute bash shell to continue."; sleep infinity diff --git a/README.md b/README.md new file mode 100644 index 0000000..053496e --- /dev/null +++ b/README.md @@ -0,0 +1,17 @@ +# 🐳🎮 RetroFW Docker Buildroot + +The RetroFW Docker Buildroot is a Docker image designed to install the [RetroFW Buildroot](https://github.com/retrofw/buildroot-retrofw-2.3) in an elegant, platform-independent and containerized way. +The ultimate goal is to simplify the software development process for RetroFW users, by automating the installation of dependencies and common libraries, and avoiding all the conflicts that the Buildroot can cause while compiling other software. + +⚠️ **Check out the [Wiki](/massivebox/retrofw-docker-buildroot/wiki) for more information, detailed installation instructions, troubleshooting tips, examples, support and more.** + +### Quick get-started guide +1. Get the image using `docker pull gitea.massivebox.net/massivebox/retrofw-docker-buildroot:latest` +2. Create a container that uses the provided image using `docker create -v CHANGEME:/mount --name buildroot gitea.massivebox.net/massivebox/retrofw-docker-buildroot`. Replace `CHANGEME` with the absolute path of a folder in your computer where you will be able to edit files from inside the container. +3. Start the container using `docker start buildroot` and connect to its Bash shell using `docker exec -it buildroot /bin/bash`. +4. Compile your project as usual. If you're having issues, check out the [Troubleshooting wiki page](/massivebox/retrofw-docker-buildroot/wiki/Troubleshooting). +5. When you're done, stop the container with `docker stop buildroot`. Next time you want to compile using the Buildroot, repeat from step 3. + +### Licensing +The code in this repository is licensed under [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html). The software that is required to run it and the software that it compiles might use a different license. Make sure to comply with all of them. +The Wiki and the README.md file are licensed under [GFDL](https://www.gnu.org/licenses/licenses.html#FDL). \ No newline at end of file