{"id":19258961,"url":"https://github.com/jz543fm/docker-parrot","last_synced_at":"2026-04-19T14:34:55.897Z","repository":{"id":211676787,"uuid":"729699901","full_name":"jz543fm/docker-parrot","owner":"jz543fm","description":"Parrot OS (Core/Security) or just Parrot Tools in Docker with the usage of Makefile, Dockerfiles and docker-compose.yaml for Bug Bounty, Penetration Testing, Security Research, Computer Forensics and Reverse Engineering, repository also contains Proof of Concept with kind (K8s in Docker) for ParrotOS with/without systemd in K8s cluster","archived":false,"fork":false,"pushed_at":"2024-04-13T08:44:34.000Z","size":32,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-05T09:29:25.527Z","etag":null,"topics":["computer-forensics","cybersecurity","docker","docker-compose","dockerfile","kubernetes","makefile","parrot","parrot-os","parrotos","pentesting","systemd"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jz543fm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"security/Dockerfile","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-10T04:04:16.000Z","updated_at":"2024-11-10T21:32:22.000Z","dependencies_parsed_at":"2024-01-02T13:46:55.870Z","dependency_job_id":"937903cb-9765-4f35-ab0d-ca2f1fb02aec","html_url":"https://github.com/jz543fm/docker-parrot","commit_stats":null,"previous_names":["jz543fm/docker-parrot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jz543fm%2Fdocker-parrot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jz543fm%2Fdocker-parrot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jz543fm%2Fdocker-parrot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jz543fm%2Fdocker-parrot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jz543fm","download_url":"https://codeload.github.com/jz543fm/docker-parrot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240356192,"owners_count":19788513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-forensics","cybersecurity","docker","docker-compose","dockerfile","kubernetes","makefile","parrot","parrot-os","parrotos","pentesting","systemd"],"created_at":"2024-11-09T19:14:54.645Z","updated_at":"2026-04-19T14:34:50.871Z","avatar_url":"https://github.com/jz543fm.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-parrot\n\n[ParrotOS Official Doc](https://parrotsec.org/docs/)\n\nParrot OS (Core/Security) or just Parrot Tools  in Docker with the usage of Makefile, Dockefiles and `docker-compose.yaml` for Bug Bounty, Penetration Testing, Security Research, Computer Forensics and Reverse Engineering. Repository also contains Proof of Concept with kind (Kubernetes in Docker) to test Parrot OS in Docker.\n\nFor the further details how it works read the `Makefile`\n\n***!!! I am using Docker host network driver, please remember that: The host networking driver only works on Linux hosts, and is not supported on Docker Desktop for Mac, Docker Desktop for Windows, or Docker EE for Windows Server !!! The usage of the host network driver is to optimize performance or to use that in a situation where container needs to handle a wide large range of ports***\n\n***If you want to run this project on the Mac, Windows, Windows server please remove from all commands --network host!!!***\n\n## Dockerhub\n\n[lostcauze7/parrot-core-systemd](https://hub.docker.com/r/lostcauze7/parrot-core-systemd)\n\n[lostcauze7/parrot-sec-systemd](https://hub.docker.com/r/lostcauze7/parrot-sec-systemd)\n\n[lostcauze7/parrot-core](https://hub.docker.com/r/lostcauze7/parrot-core)\n\n[lostcauze7/parrot-security](https://hub.docker.com/r/lostcauze7/parrot-security)\n\n## Deployment for Kubernetes\n\nLocal cluster with [Kind](http://kind.sigs.k8s.io) - (K8s in Docker):\n\n```bash\n# Creates kind cluster, 1 master + 2 worker nodes\nmake cc\n# Deletes kind cluster\nmake dc\n```\n\n### Without enabled systemd:\n\n```bash\n# ParrotOS Core:\nkubectl apply -f core/deploy/deploy.yaml\n# ParrotOS Security:\nkubectl apply -f security/deploy/deploy.yaml\n```\n\n### With enabled systemd:\n\n```bash\n# ParrotOS Core:\nkubectl apply -f systemd_k8s/core/deploy.yaml\n# ParrotOS Security:\nkubectl apply -f systemd_k8s/security/deploy.yaml\n```\n\n## Installation of Trivy\n\n[Trivy](https://trivy.dev) installation for Docker Image vulnerabilities:\n\nIf you are not using Debian/Ubuntu, read [docs](https://aquasecurity.github.io/trivy/v0.18.3/installation/)\n\nOne liner to install [Trivy](https://trivy.dev) by specific version (Linux/Ubuntu):\n\n```bash\nTRIVY_VERSION=0.44.0; curl -sSLO https://github.com/aquasecurity/trivy/releases/download/v${TRIVY_VERSION}/trivy_${TRIVY_VERSION}_Linux-64bit.deb \u0026\u0026 sudo dpkg -i trivy_${TRIVY_VERSION}_Linux-64bit.deb\n```\n\nTrivy usage:\n\n```bash\ntrivy image \u003cimage\u003e\n```\n\n### Installing Docker + Docker compose\n\nInstall Docker engine by your way you or you can install it by shell script:\n\n```bash\ncurl -fsSL https://get.docker.com -o get-docker.sh; sudo sh get-docker.sh; rm -rf get-docker.sh\n\n#Permissions:\nsudo usermod -aG docker $USER\nnewgrp docker\n```\n\nDocker compose installation (latest release), it is expected you're using only docker compose v2! Used version of **docker-compose.yaml** is **3.8**\n\n```bash\nmkdir -p ~/.docker/cli-plugins/; DOCKER_COMPOSE=2.20.2; curl -SL https://github.com/docker/compose/releases/download/v${DOCKER_COMPOSE}/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose; chmod +x ~/.docker/cli-plugins/docker-compose #permission\n\ndocker compose version #verify\n```\n\n## Local development\n\n```bash\n# Builds up the Parrot OS - Core\nmake build-core\n# Builds up the Parrot OS - Core with systemd\nmake build-core-systemd\n# Run Parrot OS - Core\nmake run-core\n# Run Parrot OS - Core with systemd\nmake run-core-s\n# Scan for vuln. in Parrot OS Core Docker Image\nmake core-scan\n# Scan for vuln. in Parrot OS Core with Docker Image with systemd\nmake core-s-scan\n# Docker stats for Parrot OS Core Docker Image\nmake core-stats\n# Docker stats for Parrot OS Core Docker Image with systemd\nmake core-s-stats\n# Builds up the Parrot OS - Security\nmake build-security\n# Builds up the Parrot OS - Security with systemd\nmake build-security-systemd\n# Run Parrot OS - Security\nmake run-security\n# Run Parrot OS - Security with systemd\nmake run-security-s\n# Scan for vuln. in Parrot OS Security Docker Image\nmake security-scan\n# Scan for vuln. in Parrot OS Security Docker Image with systemd\nmake security-s-scan\n# Docker stats for Parrot OS Security Docker Image\nmake security-stats\n# Docker stats for Parrot OS Security Docker Image with systemd\nmake security-s-stats\n# Run Parrot Tools Docker image (read Makefile) - Nmap\nmake nmap\n# Run Parrot Tools Docker image (read Makefile) - metasploit \nmake metasploit\n# Run Parrot Tools Docker image (read Makefile) - set \nmake pset\n# Run Parrot Tools Docker image (read Makefile) - bettercap \nmake bettercap\n# Run Parrot Tools Docker image (read Makefile) - sqlmap \nmake sqlmap\n\n\n## Docker compose:\n\n# Starts ParrotOS Core \u0026 Parrot OS Security docker compose services defined in docker-compose.yaml\nmake up\n# Stops and Removes ParrotOS Core \u0026 Parrot OS Security docker compose services defined in docker-compose.yaml\nmake down\n\n\n## Cleaning\n\n# Removes Volumes \nmake rm-volumes\n# Stop/remove all docker images\nmake rmrf\n# Docker prune\nmake prune\n# Docker volume prune\nmake volume-prune\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjz543fm%2Fdocker-parrot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjz543fm%2Fdocker-parrot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjz543fm%2Fdocker-parrot/lists"}