This repository can be used in two common ways: with the included Dockerfile (recommended for quick testing and reproducible environments) or on a native Ubuntu system. RISC-V-specific installation steps are not included here — see the RISC-V section below.
This repo contains the configuration, scripts, and a Dockerfile to assemble a lightweight Linux environment. It's intended to be easy to run locally for development or testing.
If you have Docker installed, this is the fastest way to get started:
-
Clone the repo:
git clone https://github.com/iamnotgoodatprogrammingplshelp/johnslinux.git cd johnslinux -
Build the Docker image (from the repository root):
docker build -t johnslinux . -
Run a container interactively:
docker run -it --rm johnslinux /bin/bash
Inspect the Dockerfile to see exactly what packages and steps are included; you can reproduce those steps on a native system if you prefer not to use Docker.
To run this on an Ubuntu host, make sure you have the basics installed (git, curl, build tools or any runtime dependencies the Dockerfile lists), then clone the repository and follow the setup steps or scripts included:
-
Update and install common prerequisites (example):
sudo apt update sudo apt install -y git curl build-essential -
Clone the repo and inspect the Dockerfile or any install scripts:
git clone https://github.com/iamnotgoodatprogrammingplshelp/johnslinux.git cd johnslinux -
If there is an install script (for example
install.sh), run it:sudo bash ./install.shIf no install script exists, open the Dockerfile and follow its RUN steps manually on your Ubuntu system to reproduce the environment.
I noticed you mentioned RISC-V installation but forgot the process. This repository does not currently include step-by-step RISC-V setup instructions. RISC-V instructions vary depending on whether you want to:
- Run a RISC-V userland in QEMU on an x86/AMD64 host, or
- Install and boot a native RISC-V board, or
- Cross-compile toolchains for RISC-V