Docker Installation
JS Recon can be also used with docker. This can be installed in a single command, however, it creates some additional steps after tool run which is not required for the normal installation. Those steps are demonstrated later in this document.
The image is only available for amd64 architecture. For users running arm64 architecture, the image is virtualized, which is slow. Read a discussion on Docker Forum here.
^ Important for 🍎 silicon users
Installation
You can get started with just pulling the image:
docker pull ghcr.io/js-recon/js-recon:latest
Or, if you prefer GitHub Container Registry, you can use the following command:
docker pull ghcr.io/js-recon/js-recon:latest
This will pull the image on your local machine.
You can try the alpha and beta builds as well. They are updated more often than the stable version, often daily, but are not as stable.
To download the alpha build, use the following command:
docker pull ghcr.io/js-recon/js-recon:alpha
docker pull ghcr.io/js-recon/js-recon:alpha
To download the beta build, use the following command:
docker pull ghcr.io/js-recon/js-recon:beta
docker pull ghcr.io/js-recon/js-recon:beta
Running JS Recon
You can run JS Recon using the following command:
docker run -it js-recon/js-recon <js_recon_arguments>
For example, to run the lazyload module, you can use the following command:
docker run -it js-recon/js-recon lazyload -u https://app.example.com
The results will be stored in the /home/pptruser directory inside the container. You should copy it before deleting the container.
Do not use --rm flag with the docker run command. It will delete the container after the run, which will delete the results as well.
Copying Results
You can copy the results using the following command:
docker cp <container_id>:/home/pptruser/<file_or_dir_name> <output_directory>
There could be multiple other files created based on the module used. You can refer to the docs of individual modules to know how to change the output files. Default files/directories are in the /home/pptruser directory with the following names:
- Lazyload:
output/(directory)
- Strings:
strings.jsonextracted_urls.jsonextracted_urls.txtextracted_urls-openapi.json
- Endpoints:
endpoints.json
- API Gateway:
.api_gateway_config.json(this is a configuration file, but is worth keeping it if generated)
- Map:
mapped.json
- Run:
- This will generate files from all of the above modules
To know the purpose of each file, you should refer to docs of the specific module - which is linked in their names above.