Quick Start

Performance Requirements

• 2G free memory
• 5G hard disk space
• Linux kernel 5.X and above (Ubuntu 22.04/kali Linux 2024.4/Debian 11)

Automatic Installation (Recommended)

bash <(curl -fsSL https://viperrtp.com/install.sh)

Get familiar with Viper's related features through Try Viper.

Manual Installation

• Switch to the root user.

su root

Unknown issues may occur when installing with sudo.

• Optimize the operating system configuration.

sysctl -w net.ipv4.tcp_timestamps=0 
sysctl -w net.ipv4.tcp_tw_reuse=1 
sysctl -w net.ipv4.tcp_tw_recycle=1 
sysctl -w net.ipv4.tcp_fin_timeout=3 
sysctl -w net.ipv4.tcp_keepalive_time=1800 
sysctl -w net.ipv4.tcp_rmem="4096 87380 8388608" 
sysctl -w net.ipv4.tcp_wmem="4096 87380 8388608" 
sysctl -w net.ipv4.tcp_max_syn_backlog=262144 
sysctl -w net.ipv4.ip_local_port_range="1024 65535"
sysctl -w net.core.rmem_max=16777216
sysctl -w net.core.wmem_max=16777216
sysctl -w net.ipv4.tcp_window_scaling=0
sysctl -w net.ipv4.tcp_sack=0
sysctl -w net.core.netdev_max_backlog=30000
sysctl -w net.ipv4.tcp_no_metrics_save=1
sysctl -w net.core.somaxconn=262144
sysctl -w net.ipv4.tcp_syncookies=0
sysctl -w net.ipv4.tcp_max_orphans=262144
sysctl -w net.ipv4.tcp_synack_retries=2
sysctl -w net.ipv4.tcp_syn_retries=2

echo "ulimit -HSn 65535" >> /etc/rc.local
echo "ulimit -HSn 65535" >>/root/.bash_profile
echo "ulimit -SHn 65535" >> /etc/profile
ulimit -SHn 65535

sysctl -w vm.max_map_count=262144

• Install docker

curl -fsSL https://get.docker.com | bash -s docker
service docker start

• Set/Generate/Enter the installation directory

export VIPER_DIR=/root/VIPER
mkdir -p $VIPER_DIR && cd $VIPER_DIR

• Generate docker-compose.yml

tee docker-compose.yml <<-'EOF'
services:
  viper:
    image: viperplatform/viper:latest
    container_name: viper-c
    network_mode: "host"
    restart: always
    volumes:
      - ${PWD}/loot:/root/.msf4/loot
      - ${PWD}/db:/root/viper/Docker/db
      - ${PWD}/module:/root/viper/Docker/module
      - ${PWD}/log:/root/viper/Docker/log
      - ${PWD}/nginxconfig:/root/viper/Docker/nginxconfig
      - ${PWD}/elasticsearch:/var/lib/elasticsearch
    ulimits:
      nofile:
        soft: 65534
        hard: 65534
      nproc:
        soft: 65534
        hard: 65534
    command: ["VIPER_PASSWORD"]
EOF

• Set the login password

export VIPER_PASSWORD=yourpassword

Replace yourpassword with a custom password.

• Write the password to docker-compose.yml

sed -i "s/VIPER_PASSWORD/$VIPER_PASSWORD/g" docker-compose.yml

-Start Viper

cd $VIPER_DIR

docker compose up -d

• Wait for 1min the system to ready, then visit https://your-vps-ip:60000 to log in.
• Username: root Password: Custom password

All docker compose commands must be executed in the installation directory to take effect.

When deploying Viper using a VPS, please confirm that the firewall of the VPS has port 60000 and subsequent ports required for handler open.

Configure anti-tracing to avoid being flagged by threat intelligence platforms.

Get familiar with Viper's related features through Try Viper.

For Mac installation, refer to issues.