{"id":13584023,"url":"https://github.com/lukaszlach/kali-desktop","last_synced_at":"2025-04-06T21:34:03.185Z","repository":{"id":45859600,"uuid":"144781037","full_name":"lukaszlach/kali-desktop","owner":"lukaszlach","description":":whale: Kali Linux desktop running in Docker on any operating system, in your web browser or a VNC client, with Kali top10 tools pre-installed.","archived":false,"fork":false,"pushed_at":"2020-12-23T18:08:49.000Z","size":5,"stargazers_count":127,"open_issues_count":4,"forks_count":52,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-02T15:54:31.006Z","etag":null,"topics":["docker","kali-linux","kde","lxde","novnc","vnc","xfce"],"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/lukaszlach.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":null,"support":null}},"created_at":"2018-08-14T23:10:17.000Z","updated_at":"2024-07-17T17:33:18.000Z","dependencies_parsed_at":"2022-07-21T23:02:33.148Z","dependency_job_id":null,"html_url":"https://github.com/lukaszlach/kali-desktop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukaszlach%2Fkali-desktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukaszlach%2Fkali-desktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukaszlach%2Fkali-desktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lukaszlach%2Fkali-desktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lukaszlach","download_url":"https://codeload.github.com/lukaszlach/kali-desktop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223265127,"owners_count":17116298,"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":["docker","kali-linux","kde","lxde","novnc","vnc","xfce"],"created_at":"2024-08-01T15:03:57.870Z","updated_at":"2024-11-06T00:31:23.431Z","avatar_url":"https://github.com/lukaszlach.png","language":"Makefile","funding_links":[],"categories":["Makefile"],"sub_categories":[],"readme":"# lukaszlach / kali-desktop\n\n[![Docker pulls](https://img.shields.io/docker/pulls/lukaszlach/kali-desktop.svg?label=docker+pulls)](https://hub.docker.com/r/lukaszlach/kali-desktop)\n[![Docker stars](https://img.shields.io/docker/stars/lukaszlach/kali-desktop.svg?label=docker+stars)](https://hub.docker.com/r/lukaszlach/kali-desktop)\n\nKali Desktop provides [Docker images](https://hub.docker.com/r/lukaszlach/kali-desktop/) with [Kali Linux](https://www.kali.org/) and a VNC server. This project allows you to pick Kali Linux version, favorite desktop environment, and run it on any system - Linux, MacOS or Windows - to access remotely and execute commands using a VNC client **or a web browser**.\n\n![](https://user-images.githubusercontent.com/5011490/44137821-0af8d0e8-a072-11e8-8962-cd21a1283a04.png)\n\n* Kali Linux 2018.2\n    * Xfce - `:xfce`\n    * LXDE - `:lxde`\n    * KDE - `:kde`\n* Kali Linux 2018.2 with Top10 tools pre-installed\n    * Xfce - `:xfce-top10`\n\n## Running\n\nAll required services and dependencies are inside the Docker images so only web browser and one command are needed to start `kali-desktop`:\n\n![](https://user-images.githubusercontent.com/5011490/44146922-0dff2d6c-a092-11e8-875a-2e2ba16dd0bd.gif)\n\nHowever the most common case is  `kali-desktop` running with host network in privileged mode, so tools like network sniffing work properly and with full speed without Docker network filtering the traffic. See all available Docker image tags on [Docker Hub](https://hub.docker.com/r/lukaszlach/kali-desktop/tags/).\n\n```bash\n# run on host network\ndocker run -d --network host --privileged lukaszlach/kali-desktop:xfce\n\n# run on Docker network\ndocker run -d -p 5900:5900 -p 6080:6080 --privileged lukaszlach/kali-desktop:xfce\n```\n\nAfter the container is up you can access Kali Linux Desktop under http://localhost:6080, the hostname can differ if you are doing this on a remote server. `vnc_auto.html` will connect you automatically, `vnc.html` allows some connection tuning.\n\n\u003e Docker for Mac works inside a small virtual machine which IP you must use to access the exposed ports or use service like [Dinghy](https://github.com/codekitchen/dinghy).\n\nIf you want to customize the container behavior you can pass additional parameters:\n\n```bash\ndocker run -d \\\n    --network host --privileged \\\n    -e RESOLUTION=1280x600x24 \\\n    -e USER=kali \\\n    -e PASSWORD=kali \\\n    -e ROOT_PASSWORD=root \\\n    -v /home/kali:/home/kali \\\n    --name kali-desktop \\\n    lukaszlach/kali-desktop:xfce\n```\n\nRun parameters:\n\n* `--network host` - optional but recommended, use the host network interfaces, if you do not need to use this option you have to manually publish the ports by passing `-p 5900:5900 -p 6080:6080`\n* `--privileged` - optional but recommended\n* `-e RESOLUTION` - optional, set streaming resolution and color depth, default `1280x600x24`\n* `-e USER` - optional, work as a user with provided name, default `root`\n* `-e PASSWORD` - optional, provide a password for USER, default `kali`\n* `-e ROOT_PASSWORD` - optional, provide password for root, default `root`\n* `-v /home/kali:/home/kali` - optional, if USER was provided it is a good idea to persist user settings, work files and look-and-feel\n\nExposed ports:\n\n* `5900/tcp` - VNC\n* `6080/tcp` - noVNC, web browser VNC client\n\n## Extending\n\nCreate `Dockerfile.xfce-web` and modify the image as desired, below example installs Kali Linux web application assessment tools:\n\n```\nFROM lukaszlach/kali-desktop:xfce\n\nRUN apt-get update \u0026\u0026 \\\n    apt-get install -y kali-linux-web \\\n    apt-get clean \u0026\u0026 \\\n    rm -rf /var/lib/apt/lists/*\n```\n\nBuild the image:\n\n```bash\ndocker build \\\n    -f Dockerfile.xfce-web \\\n    -t kali-desktop:xfce-web \\\n    .\n```\n\nRun the image:\n\n```bash\ndocker run --network host --privileged kali-desktop:xfce-web\n```\n\n## Licence\n\nMIT License\n\nCopyright (c) 2018 Łukasz Lach \u003cllach@llach.pl\u003e\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flukaszlach%2Fkali-desktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flukaszlach%2Fkali-desktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flukaszlach%2Fkali-desktop/lists"}