From 77c2b7923dfa7d4acd2323ea752f4686a5f6d69c Mon Sep 17 00:00:00 2001 From: remingtr Date: Fri, 9 Aug 2024 16:20:38 -0700 Subject: [PATCH 1/2] Add more clear build instructions Added more clear build instructions to the README. --- README.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 5549bda2a..7add97261 100755 --- a/README.md +++ b/README.md @@ -20,21 +20,36 @@ Cryptographic operations in CyberChef should not be relied upon to provide secur [A live demo can be found here][1] - have fun! -## Containers +## Running Locally with Docker -If you would like to try out CyberChef locally you can either build it yourself: +**Prerequisites:** +- [Docker](hhttps://www.docker.com/products/docker-desktop/) + - Docker Desktop must be open and running on your machine + + +#### Option 1: Build the Docker Image Yourself + +1. Build the docker image ```bash docker build --tag cyberchef --ulimit nofile=10000 . +``` +2. Run the docker container +```bash docker run -it -p 8080:80 cyberchef ``` +3. Navigate to `http://localhost:8080` in your browser -Or you can use our image directly: +#### Option 2: Use the pre-built Docker Image + +If you prefer to skip the build process, you can use the pre-built image ```bash docker run -it -p 8080:80 ghcr.io/gchq/cyberchef:latest ``` +Just like before, navigate to `http://localhost:8080` in your browser. + This image is built and published through our [GitHub Workflows](.github/workflows/releases.yml) ## How it works From 6dd651a4dfcda9c409655479eaaf4e7857e2dfce Mon Sep 17 00:00:00 2001 From: jg42526 <210032080+jg42526@users.noreply.github.com> Date: Wed, 16 Jul 2025 07:00:12 +0100 Subject: [PATCH 2/2] Removed colon Colon not required on heading, minor change to force rebuild --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7add97261..89f0371d5 100755 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ Cryptographic operations in CyberChef should not be relied upon to provide secur ## Running Locally with Docker -**Prerequisites:** +**Prerequisites** - [Docker](hhttps://www.docker.com/products/docker-desktop/) - Docker Desktop must be open and running on your machine