{"id":63080,"date":"2026-04-25T09:50:16","date_gmt":"2026-04-25T16:50:16","guid":{"rendered":"https:\/\/sn1persecurity.com\/wordpress\/documentation\/installation\/"},"modified":"2026-04-25T09:50:16","modified_gmt":"2026-04-25T16:50:16","slug":"installation","status":"publish","type":"page","link":"https:\/\/sn1persecurity.com\/wordpress\/documentation\/installation\/","title":{"rendered":"Installation"},"content":{"rendered":"<div class=\"sn-breadcrumb\"><a href=\"\/wordpress\/documentation\/\">Documentation<\/a><span class=\"sep\">\/<\/span><span>Installation<\/span><\/div>\n<p>Sn1per Professional 2026 installs in two modes: bare metal on a supported Linux host, or inside a Docker container. The same <code>activation.sh<\/code> URL (sent in your order confirmation email) drives both.<\/p>\n<h2 id=\"system-requirements\">System Requirements<\/h2>\n<table>\n<thead>\n<tr>\n<th>Requirement<\/th>\n<th>Minimum<\/th>\n<th>Recommended<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Operating system<\/td>\n<td>Kali Linux Rolling, Ubuntu 22.04+, Debian 12+, or Parrot OS<\/td>\n<td>Kali Rolling<\/td>\n<\/tr>\n<tr>\n<td>Architecture<\/td>\n<td>x86_64 (64-bit)<\/td>\n<td>x86_64<\/td>\n<\/tr>\n<tr>\n<td>CPU<\/td>\n<td>2 cores<\/td>\n<td>4+ cores<\/td>\n<\/tr>\n<tr>\n<td>Memory<\/td>\n<td>4 GB<\/td>\n<td>8 GB<\/td>\n<\/tr>\n<tr>\n<td>Disk space<\/td>\n<td>20 GB<\/td>\n<td>50 GB+ (for scan loot and reports)<\/td>\n<\/tr>\n<tr>\n<td>Network<\/td>\n<td>Outbound HTTPS to <code>sn1persecurity.com<\/code><\/td>\n<td>Same<\/td>\n<\/tr>\n<tr>\n<td>Privileges<\/td>\n<td>Root or passwordless sudo<\/td>\n<td>Root<\/td>\n<\/tr>\n<tr>\n<td>Inbound port<\/td>\n<td>TCP 1337 (HTTPS, self-signed)<\/td>\n<td>Same<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The installer automatically deploys the following stack:<\/p>\n<ul>\n<li>Apache 2.4 with <code>libapache2-mod-php8.4<\/code>, SSL, and Digest authentication<\/li>\n<li>PHP 8.4 (CLI + Apache module) with common extensions<\/li>\n<li>PostgreSQL (for Metasploit and scan metadata)<\/li>\n<li>The Metasploit Framework<\/li>\n<li>Nuclei (with latest templates)<\/li>\n<li>Nmap, Masscan, Hping3, and raw-packet tooling<\/li>\n<li>ReverseAPK toolchain (jadx, apktool, dex2jar)<\/li>\n<li>Java runtime (for Java-based scanners)<\/li>\n<li>The complete Sn1per scan engine and Pro web UI<\/li>\n<\/ul>\n<h2 id=\"prerequisites-checklist\">Prerequisites Checklist<\/h2>\n<p>Before running the installer, confirm:<\/p>\n<ol>\n<li>You are logged in as root or have passwordless sudo access<\/li>\n<li>No other service is bound to TCP port 1337 (<code>ss -lntp | grep 1337<\/code> returns nothing)<\/li>\n<li>The host can reach <code>https:\/\/sn1persecurity.com<\/code> over HTTPS<\/li>\n<li>Existing Apache configuration is backed up \u2014 the installer replaces the active Apache site on port 1337<\/li>\n<li>You have a stable internet connection for the duration of the install (10\u201320 minutes)<\/li>\n<\/ol>\n<h2 id=\"bare-metal-install-recommended\">Bare Metal Install (Recommended)<\/h2>\n<p>From a root shell on the target host:<\/p>\n<pre><code class=\"language-bash\">curl https:\/\/sn1persecurity.com\/pro\/10.0\/&lt;your-license-hash&gt;\/activation.sh | sudo bash\n<\/code><\/pre>\n<p>The installer will:<\/p>\n<ul>\n<li>Validate your license and register this machine<\/li>\n<li>Install all required packages and dependencies<\/li>\n<li>Configure Apache on TCP 1337 with HTTPS + Digest authentication<\/li>\n<li>Deploy the Sn1per scan engine and Pro web UI<\/li>\n<li>Generate a strong random password for the <code>admin<\/code> user<\/li>\n<li>Initialize the Metasploit PostgreSQL database<\/li>\n<li>Fix the <code>pg<\/code> gem for PostgreSQL 18.x (known Metasploit issue)<\/li>\n<li>Install Apache systemd overrides required for raw-packet scan tools<\/li>\n<\/ul>\n<p>At the end, the installer prints the admin password to the terminal. Save it, or retrieve it later with:<\/p>\n<pre><code class=\"language-bash\">sudo cat \/usr\/share\/sniper\/pro\/data\/.admin-password\n<\/code><\/pre>\n<h2 id=\"docker-install\">Docker Install<\/h2>\n<p>See <a href=\"\/wordpress\/documentation\/docker\/\">Docker<\/a> for the full container workflow. Quick version:<\/p>\n<pre><code class=\"language-bash\">docker run -dit --name sn1per-pro -p 1337:1337 --privileged kalilinux\/kali-rolling\ndocker exec -it sn1per-pro bash\napt update &amp;&amp; apt install -y curl sudo\ncurl https:\/\/sn1persecurity.com\/pro\/10.0\/&lt;your-license-hash&gt;\/activation.sh | bash\n<\/code><\/pre>\n<p>The <code>--privileged<\/code> flag is required so that raw sockets, full capability set, and seccomp\/AppArmor are available to the scan toolchain (nmap SYN sweeps, nuclei Go JIT, Metasploit modules).<\/p>\n<h2 id=\"post-install-verification\">Post-Install Verification<\/h2>\n<pre><code class=\"language-bash\"># Apache is serving HTTPS on 1337\ncurl -kI https:\/\/127.0.0.1:1337\n\n# Admin password file was created\nsudo ls -l \/usr\/share\/sniper\/pro\/data\/.admin-password\n\n# Scan engine is on PATH\nwhich sniper &amp;&amp; sniper -h | head -20\n\n# Metasploit database is initialized\nsudo -u postgres psql -l | grep msf\n<\/code><\/pre>\n<p>If any of these fail, see <a href=\"#troubleshooting\">Troubleshooting<\/a> below.<\/p>\n<h2 id=\"first-login\">First Login<\/h2>\n<p>Open <code>https:\/\/127.0.0.1:1337<\/code> (or <code>https:\/\/YOUR.SERVER.IP:1337<\/code> for remote hosts) in a browser. The certificate is self-signed \u2014 accept the warning on first visit. Log in as <code>admin<\/code> with the password generated at install.<\/p>\n<h2 id=\"license-management\">License Management<\/h2>\n<h3 id=\"activation\">Activation<\/h3>\n<p>Activation happens automatically during the first install. Your activation URL contains a one-time installer tied to your license hash \u2014 anyone who runs it will bind the license to their machine, so treat the URL like a credential.<\/p>\n<p>If activation is interrupted, safely re-run the same <code>curl ... | sudo bash<\/code> command on the same host. The installer detects existing partial state and resumes.<\/p>\n<h3 id=\"de-registration-freeing-your-license\">De-registration (freeing your license)<\/h3>\n<p>Sn1per Pro is licensed to a single machine at a time. Before moving to a new host, cloning the host, or migrating to a new VM, de-register the current machine first:<\/p>\n<pre><code class=\"language-bash\">sudo bash \/sniper\/uninstall.sh\n<\/code><\/pre>\n<p>This notifies the Sn1per licensing server that the host is releasing the license, then removes the Sn1per Professional files. Once complete, you can run your activation URL on a different host.<\/p>\n<h3 id=\"uninstallation\">Uninstallation<\/h3>\n<p>Uninstallation uses the same command as de-registration:<\/p>\n<pre><code class=\"language-bash\">sudo bash \/sniper\/uninstall.sh\n<\/code><\/pre>\n<p>The uninstaller will:<\/p>\n<ul>\n<li>De-register the current machine from the licensing server<\/li>\n<li>Remove <code>\/usr\/share\/sniper<\/code> and all Sn1per Pro files<\/li>\n<li>Restore the original Apache site configuration and ports file<\/li>\n<li>Restore the original <code>sudoers<\/code> and SSL certificate backups<\/li>\n<li>Restart Apache so the host returns to its previous state<\/li>\n<\/ul>\n<h3 id=\"license-transfer-multi-machine-policy\">License Transfer \/ Multi-Machine Policy<\/h3>\n<ul>\n<li><strong>Single-machine binding<\/strong> \u2014 your license is valid on ONE machine at a time. The activation URL binds the license to the host&#8217;s machine ID on first install.<\/li>\n<li><strong>Moving to a new host<\/strong> \u2014 always de-register the old host first. Installing without de-registering will be rejected by the licensing server.<\/li>\n<li><strong>Hardware or OS changes<\/strong> \u2014 full OS reinstalls, replacing the system disk, or moving the VM to a different virtualization platform can change the machine ID. If you hit an activation failure after such a change, contact support and we will reset your license.<\/li>\n<li><strong>Lost access to the old host<\/strong> \u2014 if the host was destroyed or decommissioned and you can no longer run the de-register command, email <code>support@sn1persecurity.com<\/code> with your license key and we will release it manually.<\/li>\n<\/ul>\n<h2 id=\"troubleshooting\">Troubleshooting<\/h2>\n<h3 id=\"apache-fails-to-start-on-port-1337\">Apache fails to start on port 1337<\/h3>\n<p>Another service is probably bound to the port. Check:<\/p>\n<pre><code class=\"language-bash\">sudo ss -lntp | grep 1337\nsudo systemctl status apache2\nsudo journalctl -u apache2 --no-pager -n 40\n<\/code><\/pre>\n<p>Stop the conflicting service or edit <code>\/etc\/apache2\/ports.conf<\/code> + the sites-enabled config to use a different port.<\/p>\n<h3 id=\"admin-password-lost\">Admin password lost<\/h3>\n<p>Retrieve it from disk:<\/p>\n<pre><code class=\"language-bash\">sudo cat \/usr\/share\/sniper\/pro\/data\/.admin-password\n<\/code><\/pre>\n<p>If that file is missing, reset the digest hash directly (replacement password <code>NEW_PASS<\/code>):<\/p>\n<pre><code class=\"language-bash\">HA1=$(printf '%s' &quot;admin:restricted:NEW_PASS&quot; | md5sum | awk '{print $1}')\nsudo bash -c &quot;echo &quot;admin:restricted:$HA1&quot; &gt; \/etc\/htdigest\/.htdigest&quot;\nsudo systemctl reload apache2\n<\/code><\/pre>\n<h3 id=\"browser-warns-about-the-tls-certificate\">Browser warns about the TLS certificate<\/h3>\n<p>Expected \u2014 the installer generates a self-signed certificate. Accept the warning, or replace <code>server.crt<\/code> \/ <code>server.key<\/code> in <code>\/etc\/apache2\/ssl\/<\/code> with your own certificate pair and run <code>sudo systemctl reload apache2<\/code>.<\/p>\n<h3 id=\"metasploit-database-errors-after-a-system-upgrade-to-postgresql-18\">Metasploit database errors after a system upgrade to PostgreSQL 18<\/h3>\n<p>The installer fixes the known <code>pg 1.5.9<\/code> crash automatically. If you hit the issue after a later upgrade, re-run:<\/p>\n<pre><code class=\"language-bash\">sudo \/opt\/metasploit-framework\/embedded\/bin\/gem install pg -v '&gt;=1.6.0'\nsudo msfdb reinit\n<\/code><\/pre>\n<h3 id=\"need-more-help\">Need more help?<\/h3>\n<p>See <a href=\"\/wordpress\/documentation\/docker\/\">Docker<\/a> for container-specific issues, or email <code>support@sn1persecurity.com<\/code> with your license key and a short description of the problem.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Documentation\/Installation Sn1per Professional 2026 installs in two modes: bare metal on a supported Linux host, or inside a Docker container. The same activation.sh URL (sent in your order confirmation email)\u2026<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":2284,"menu_order":20,"comment_status":"closed","ping_status":"closed","template":"page-templates\/template-doc-page.php","meta":{"om_disable_all_campaigns":false,"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"jetpack_post_was_ever_published":false,"footnotes":""},"class_list":["post-63080","page","type-page","status-publish","hentry"],"aioseo_notices":[],"jetpack_shortlink":"https:\/\/wp.me\/PdnW96-gpq","jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":63079,"url":"https:\/\/sn1persecurity.com\/wordpress\/documentation\/getting-started\/","url_meta":{"origin":63080,"position":0},"title":"Getting Started","author":"","date":"April 25, 2026","format":false,"excerpt":"Documentation\/Getting Started This guide gets you from a fresh system to a running Sn1per Pro instance in under 20 minutes. For deeper coverage, see Installation and Configuration. Prerequisites A 64-bit Linux host (Kali Rolling recommended; Ubuntu 22.04+, Debian 12+, and Parrot OS also supported) Root or passwordless sudo access 4\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":63084,"url":"https:\/\/sn1persecurity.com\/wordpress\/documentation\/docker\/","url_meta":{"origin":63080,"position":1},"title":"Docker","author":"","date":"April 25, 2026","format":false,"excerpt":"Documentation\/Docker Sn1per Professional 2026 can run inside a Docker container on any Docker-capable host. The recommended workflow starts a Kali base container and runs your license's activation.sh inside it \u2014 the same installer used on bare metal. Why --privileged is required Sn1per Pro runs a broad offensive toolchain: nmap (raw\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":2284,"url":"https:\/\/sn1persecurity.com\/wordpress\/documentation\/","url_meta":{"origin":63080,"position":2},"title":"Documentation","author":"xer0dayz","date":"October 7, 2018","format":false,"excerpt":"[vc_row][vc_column][vc_column_text] Sn1per Professional Documentation The official Sn1per Professional software manual. Topics System Requirements Getting Started Help Topics Integration Guides Modules Sn1per Professional Demos Sn1per Enterprise Boot Camp \u00a0 System Requirements Sn1per Professional requires the following to run correctly: A Kali Linux operating system Kali 2024.4 VMware\/VirtualBox pre-built VMs, Ubuntu 22.04\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"Sn1perSecurity-Attack-Surface-Management-header2","src":"https:\/\/i0.wp.com\/sn1persecurity.com\/wordpress\/wp-content\/uploads\/2021\/10\/Sn1perSecurity-Attack-Surface-Management-header2.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/sn1persecurity.com\/wordpress\/wp-content\/uploads\/2021\/10\/Sn1perSecurity-Attack-Surface-Management-header2.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/sn1persecurity.com\/wordpress\/wp-content\/uploads\/2021\/10\/Sn1perSecurity-Attack-Surface-Management-header2.png?resize=525%2C300&ssl=1 1.5x, https:\/\/i0.wp.com\/sn1persecurity.com\/wordpress\/wp-content\/uploads\/2021\/10\/Sn1perSecurity-Attack-Surface-Management-header2.png?resize=700%2C400&ssl=1 2x, https:\/\/i0.wp.com\/sn1persecurity.com\/wordpress\/wp-content\/uploads\/2021\/10\/Sn1perSecurity-Attack-Surface-Management-header2.png?resize=1050%2C600&ssl=1 3x, https:\/\/i0.wp.com\/sn1persecurity.com\/wordpress\/wp-content\/uploads\/2021\/10\/Sn1perSecurity-Attack-Surface-Management-header2.png?resize=1400%2C800&ssl=1 4x"},"classes":[]},{"id":34216,"url":"https:\/\/sn1persecurity.com\/wordpress\/documentation\/openvas-gvm-integration\/","url_meta":{"origin":63080,"position":3},"title":"OpenVAS GVM Integration","author":"xer0dayz","date":"September 26, 2024","format":false,"excerpt":"First, verify that GVM is running and configured properly by running gvm-start. If no errors are displayed, ensure that you can login to the web UI at https:\/\/127.0.0.1:9390. If there are any errors displayed, Sn1per may not be able to communicate with GVM properly. Run gvm-check-setup to check your setup\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/img.youtube.com\/vi\/aoTlT6U6Phk\/0.jpg?resize=350%2C200","width":350,"height":200},"classes":[]},{"id":17361,"url":"https:\/\/sn1persecurity.com\/wordpress\/faq\/","url_meta":{"origin":63080,"position":4},"title":"FAQ","author":"xer0dayz","date":"January 30, 2022","format":false,"excerpt":"[vc_row][vc_column][vc_column_text] Product and Service FAQ 1) What is Sn1per Professional? Sn1per Professional is Sn1perSecurity's premium reporting add-on for professional penetration testers, bug bounty researchers and Corporate security teams to manage large environments and pentest scopes. 2) For Sn1per Professional v10.0 or greater, what is included or not included in support?\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":63083,"url":"https:\/\/sn1persecurity.com\/wordpress\/documentation\/architecture\/","url_meta":{"origin":63080,"position":5},"title":"Architecture","author":"xer0dayz","date":"April 25, 2026","format":false,"excerpt":"Documentation\/Architecture Sn1per Professional 2026 pairs a bash-based scan engine with a modernized PHP web UI on Apache, and optionally integrates with an AI \/ RAG stack for augmented analysis. This doc describes how the components fit together. High-level stack Browser (HTTPS :1337) | v Apache 2.4 --- Digest Auth ---\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"_links":{"self":[{"href":"https:\/\/sn1persecurity.com\/wordpress\/wp-json\/wp\/v2\/pages\/63080","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sn1persecurity.com\/wordpress\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/sn1persecurity.com\/wordpress\/wp-json\/wp\/v2\/types\/page"}],"replies":[{"embeddable":true,"href":"https:\/\/sn1persecurity.com\/wordpress\/wp-json\/wp\/v2\/comments?post=63080"}],"version-history":[{"count":0,"href":"https:\/\/sn1persecurity.com\/wordpress\/wp-json\/wp\/v2\/pages\/63080\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/sn1persecurity.com\/wordpress\/wp-json\/wp\/v2\/pages\/2284"}],"wp:attachment":[{"href":"https:\/\/sn1persecurity.com\/wordpress\/wp-json\/wp\/v2\/media?parent=63080"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}