# Sysreptor

Sysreptor is my favorite pentest report writing service.

The install notes below are from June 2024 so they might be old but wanted to put them here for reference:

# Install (Ubuntu 24.04)

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Get the rest of the Ubuntu pre-reqs:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Get the sysrep install re-reqs:

sudo apt update sudo apt install -y sed curl openssl uuid-runtime coreutils

Install sysreptor!

curl -s https://docs.sysreptor.com/install.sh | sudo bash

# Bring sysreptor image up

cd ~/sysreptorfolder/deploy
sudo docker compose up

# Bring sysreptor image down

cd ~/sysreptorfolder/deploy
sudo docker compose down

# Restore from encrypted backup

cd ~/sysreptorfolder/deploy
cat ~/restores/backup.zip.crypt | sudo docker compose run --rm --no-TTY app python3 manage.py restorebackup --key "YOUR-ENCRYPTED-BACKUP-KEY"

# Fixing the annoying "Could not establish WebSocket connection, falling back to HTTP" error

Open up .env and make sure you've established a line that specifies your FQDN:

ALLOWED_HOSTS="sysreptor.example.com"