{"id":7591,"date":"2021-01-10T20:37:28","date_gmt":"2021-01-10T17:37:28","guid":{"rendered":"https:\/\/kifarunix.com\/?p=7591"},"modified":"2024-03-19T20:59:29","modified_gmt":"2024-03-19T17:59:29","slug":"install-rengine-on-ubuntu","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/install-rengine-on-ubuntu\/","title":{"rendered":"Install reNgine on Ubuntu 20.04|Ubuntu 18.04"},"content":{"rendered":"\n<p>In this tutorial, you will learn how to install reNgine on Ubuntu 20.04|Ubuntu 18.04. <em><strong><a aria-label=\" (opens in a new tab)\" href=\"https:\/\/rengine.wiki\/\" target=\"_blank\" rel=\"noreferrer noopener\" class=\"rank-math-link\">reNgine<\/a><\/strong>&nbsp;is an automated reconnaissance framework meant information gathering during penetration testing of web applications.&nbsp;It&nbsp;has pipeline of highly configurable reconnaissance steps. With the integration of various open source information gathering tools,&nbsp;<strong>reNgine<\/strong>, uses all or some of them depending upon the configuration and gathers the results at a single place<\/em>.<\/p>\n\n\n\n<p>As a reconnaissance framework, below are the reNgine capabilities;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Subdomain Discovery<\/strong>: Discovers all the subdomains using tools like sublist3r, subfinder, amass, asset finder, etc.<\/li>\n\n\n\n<li><strong>Port Scan<\/strong>: Use to identify the open ports on the subdomains that have been discovered. Currently reNgine uses naabu to check for open ports.&nbsp;<em>We have plans to use masscan in the future.<\/em><\/li>\n\n\n\n<li><strong>Directory and File Search<\/strong>: Uses&nbsp;<code>dirsearch<\/code>&nbsp;to discover the directories and files.<\/li>\n\n\n\n<li><strong>Fetch all Endpoints<\/strong>: Fetches all the urls for each subdomains from various sources like Open Threat Exchange, Wayback machine, common crawl etc. reNgine uses&nbsp;<code>gau<\/code>,&nbsp;<code>hakrawler<\/code>&nbsp;to fetch the endpoints.<\/li>\n\n\n\n<li><strong>Vulnerability Scan<\/strong>&nbsp;<em>(Beta)<\/em>: reNgine uses&nbsp;<code>nuclei<\/code>&nbsp;to perform the Vulnerability Scans on the targets.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Installing reNgine on Ubuntu 20.04|18.04<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Prerequisites<\/h3>\n\n\n\n<p>There are a number of tools that reNgine requires to be installed prior to its installation.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Install Docker Engine on Ubuntu 20.04|Ubuntu 18.04<\/h4>\n\n\n\n<p>Using Docker to run reNgine is one of the easiest methods. As such, you need to first install Docker. Follow the link below to install Docker on Ubuntu 20.04|Ubuntu 18.04.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code><a aria-label=\"Install Docker CE on Ubuntu 20.04 (opens in a new tab)\" href=\"https:\/\/kifarunix.com\/install-docker-ce-on-ubuntu-20-04\/\" target=\"_blank\" rel=\"noreferrer noopener\" class=\"rank-math-link\">Install Docker CE on Ubuntu 20.04<\/a><\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Install Docker Compose on Ubuntu 20.04|Ubuntu 18.04<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Download the latest stable version of&nbsp;<code>docker-compose<\/code><\/li>\n<\/ul>\n\n\n\n<pre id=\"__code_5\" class=\"wp-block-preformatted\">sudo curl -L \"https:\/\/github.com\/docker\/compose\/releases\/download\/1.27.4\/docker-compose-$(uname -s)-$(uname -m)\" -o \/usr\/local\/bin\/docker-compose\n<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Apply executable permission<\/li>\n<\/ul>\n\n\n\n<pre id=\"__code_6\" class=\"wp-block-preformatted\">sudo chmod +x \/usr\/local\/bin\/docker-compose\n<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Create a symbolic link<\/li>\n<\/ul>\n\n\n\n<pre id=\"__code_7\" class=\"wp-block-preformatted\">sudo ln -s \/usr\/local\/bin\/docker-compose \/usr\/bin\/docker-compose\n<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verify your installation by running<\/li>\n<\/ul>\n\n\n\n<pre id=\"__code_8\" class=\"wp-block-preformatted\">docker-compose --version<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">Install Make and Other Build tools on Ubuntu 20.04|Ubuntu 18.04<\/h4>\n\n\n\n<p>Run the command below to install <strong><code>make<\/code><\/strong> and <code><strong>build-essential<\/strong><\/code> on Ubuntu 20.04|Ubuntu 18.04<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>apt install make build-essential<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Installing reNgine on Ubuntu<\/h3>\n\n\n\n<p>Once your system has met all the prerequisites above, then you are good to proceed to install reNgine.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Clone the&nbsp;<strong>reNgine<\/strong> Github repository<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>git clone https:\/\/github.com\/yogeshojha\/rengine <\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Navigate to reNgine directory, once the clone is done;<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>cd rengine<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Update reNgine environment variables required for setup;<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>vim .env<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>#\n# General\n#\nCOMPOSE_PROJECT_NAME=rengine\n\n#\n# SSL specific configuration\n#\nAUTHORITY_NAME=reNgine\nAUTHORITY_PASSWORD=changeme\nCOMPANY=Kifarunix-demo\nDOMAIN_NAME=recon.kifarunix-demo.com\nCOUNTRY_CODE=US\nSTATE=Georgia\nCITY=Atlanta<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>NOTE: You MUST be inside the rengine while running the make commands.<\/li>\n\n\n\n<li>Generating reNgine SSL Certificates<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>make certs<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>...\nCreating new certificate for recon.kifarunix-demo.com\nGenerating RSA private key, 4096 bit long modulus (2 primes)\n.......++++\n......................................................++++\ne is 65537 (0x010001)\nSignature ok\nsubject=C = US, ST = Georgia, L = Atlanta, O = Kifarunix-demo, CN = recon.kifarunix-demo.com\nGetting CA Private Key\ntotal 24\n-rw-r--r--    1 root     root          2041 Jan 10 06:00 ca.crt\n-rw-------    1 root     root          3243 Jan 10 06:00 ca.key\n-rw-r--r--    1 root     root             3 Jan 10 06:00 ca.srl\n-rw-r--r--    1 root     root          1830 Jan 10 06:00 rengine.pem\n-rw-r--r--    1 root     root          2041 Jan 10 06:00 rengine_chain.pem\n-rw-------    1 root     root          3243 Jan 10 06:00 rengine_rsa.key<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You can now build reNgine framework. The process might take sometime though!<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>make build<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Running reNgine on Ubuntu 20.04|Ubuntu 18.04<\/h3>\n\n\n\n<p>Once reNgine build is done successfully, you can now run reNgine by executing the command below from within the rengine git directory;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>make up<\/code><\/pre>\n\n\n\n<p>Before you can run the command above, ensure no service is using the default web server port 80.<\/p>\n\n\n\n<p>Once reNgine is up, you can list its running container;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>docker ps<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>CONTAINER ID   IMAGE                                                     COMMAND                  CREATED         STATUS         PORTS                                      NAMES\n8ed371f18774   nginx:alpine                                              \"\/docker-entrypoint.\u2026\"   3 minutes ago   Up 3 minutes   0.0.0.0:80-&gt;80\/tcp, 0.0.0.0:443-&gt;443\/tcp   rengine_proxy_1\n4e296aa185b7   rengine_celery                                            \"\/app\/docker-entrypo\u2026\"   3 minutes ago   Up 3 minutes                                              rengine_celery_1\n62822b042cce   docker.pkg.github.com\/yogeshojha\/rengine\/rengine:latest   \"\/app\/docker-entrypo\u2026\"   3 minutes ago   Up 3 minutes                                              rengine_web_1\n4021a0151f08   rengine_celery-beat                                       \"\/app\/docker-entrypo\u2026\"   3 minutes ago   Up 3 minutes                                              rengine_celery-beat_1\n7695fa3f292c   postgres:12.3-alpine                                      \"docker-entrypoint.s\u2026\"   5 minutes ago   Up 5 minutes   5432\/tcp                                   rengine_db_1\nb2eaefa78f71   redis:alpine                                              \"docker-entrypoint.s\u2026\"   5 minutes ago   Up 5 minutes   6379\/tcp                                   rengine_redis_1<\/code><\/pre>\n\n\n\n<p>To restart reNgine use the command<\/p>\n\n\n\n<pre id=\"__code_22\" class=\"wp-block-preformatted\">make restart<\/code><\/pre>\n\n\n\n<p id=\"stopping-the-rengine\">You can stop the reNgine by running the command.<\/p>\n\n\n\n<pre id=\"__code_21\" class=\"wp-block-preformatted\">make stop<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Accessing reNgine from Browser<\/h3>\n\n\n\n<p>Note that the web server container listening on port 80 is mapped to listen on the host port 443 (<strong>0.0.0.0:80-&gt;80\/tcp, 0.0.0.0:443-&gt;443\/tcp<\/strong>). This means that you can access reNgine from browser using the URL, <code>https:\/\/&lt;DOMAIN_NAME set on .env file&gt;<\/code> or <code>https:\/\/your_vps_ip_address<\/code>.<\/p>\n\n\n\n<p>Accept the use of self-signed SSL on browser and proceed to reNgine login page.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Create reNgine User Account<\/h3>\n\n\n\n<p>In order to be able to login to reNgine, you need to create a username and password. You can use <code>make<\/code> command (run within the reNgine git repo directory) as follows;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\"><code>make username<\/code><\/pre>\n\n\n\n<p>You will be prompted to enter the username (root by default), the email address and the user password.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1084\" height=\"804\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login.png\" alt=\"Install reNgine on Ubuntu\" class=\"wp-image-7596\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login.png?v=1610299688 1084w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-768x570.png?v=1610299688 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-150x111.png?v=1610299688 150w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-300x223.png?v=1610299688 300w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-485x360.png?v=1610299688 485w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-696x516.png?v=1610299688 696w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-1068x792.png?v=1610299688 1068w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-566x420.png?v=1610299688 566w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-80x60.png?v=1610299688 80w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-login-265x198.png?v=1610299688 265w\" sizes=\"(max-width: 1084px) 100vw, 1084px\" \/><\/figure>\n\n\n\n<p>Once you have created a user account, you can use it to login to reNgine from the browser.<\/p>\n\n\n\n<p>reNgine dashboard.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1854\" height=\"805\" src=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard.png\" alt=\"\" class=\"wp-image-7597\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard.png?v=1610299738 1854w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard-768x333.png?v=1610299738 768w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard-1536x667.png?v=1610299738 1536w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard-150x65.png?v=1610299738 150w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard-300x130.png?v=1610299738 300w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard-696x302.png?v=1610299738 696w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard-1068x464.png?v=1610299738 1068w, https:\/\/kifarunix.com\/wp-content\/uploads\/2021\/01\/rengine-dashboard-967x420.png?v=1610299738 967w\" sizes=\"(max-width: 1854px) 100vw, 1854px\" \/><\/figure>\n\n\n\n<p>And there you go. You can now add assets to scan and schedule your scanning.<\/p>\n\n\n\n<p>That marks the end of our tutorial on how to install reNgine.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Reference<\/h3>\n\n\n\n<p><a aria-label=\"Installing reNgine (opens in a new tab)\" href=\"https:\/\/rengine.wiki\/pentester\/install\/#for-penetration-testers\" target=\"_blank\" rel=\"noreferrer noopener\" class=\"rank-math-link\">Installing reNgine<\/a><\/p>\n\n\n\n<p><a aria-label=\"reNgine Documentation (opens in a new tab)\" href=\"https:\/\/rengine.wiki\/\" target=\"_blank\" rel=\"noreferrer noopener\" class=\"rank-math-link\">reNgine Documentation<\/a><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Related Tutorials<\/h4>\n\n\n\n<p><a aria-label=\" (opens in a new tab)\" href=\"https:\/\/kifarunix.com\/install-and-setup-gvm-11-on-ubuntu-20-04\/\" target=\"_blank\" rel=\"noreferrer noopener\" class=\"rank-math-link\">Install and Setup GVM 11 on Ubuntu 20.04<\/a><\/p>\n\n\n\n<p><a aria-label=\" (opens in a new tab)\" href=\"https:\/\/kifarunix.com\/install-wpscan-on-ubuntu-20-04\/\" target=\"_blank\" rel=\"noreferrer noopener\" class=\"rank-math-link\">Install WPScan on Ubuntu 20.04<\/a><\/p>\n\n\n\n<p><a aria-label=\" (opens in a new tab)\" href=\"https:\/\/kifarunix.com\/install-and-setup-dvwa-on-centos-8\/\" target=\"_blank\" rel=\"noreferrer noopener\" class=\"rank-math-link\">Install and Setup DVWA on CentOS 8<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>In this tutorial, you will learn how to install reNgine on Ubuntu 20.04|Ubuntu 18.04. reNgine&nbsp;is an automated reconnaissance framework meant information gathering during penetration testing<\/p>\n","protected":false},"author":1,"featured_media":7596,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_lock_modified_date":false,"footnotes":""},"categories":[34,121,150],"tags":[3001,3003,3004,3002],"class_list":["post-7591","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-security","category-howtos","category-vulnerability-scanners","tag-install-rengine","tag-installing-rengine-on-ubuntu-20-04","tag-rengine-scanner","tag-setup-rengine-on-ubuntu","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-50","resize-featured-image"],"_links":{"self":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/7591"}],"collection":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/comments?post=7591"}],"version-history":[{"count":7,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/7591\/revisions"}],"predecessor-version":[{"id":21975,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/7591\/revisions\/21975"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media\/7596"}],"wp:attachment":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media?parent=7591"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/categories?post=7591"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/tags?post=7591"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}