Support - Security-Tools-Alliance/rengine-ng GitHub Wiki

reNgine-ng Troubleshooting Guide

Table of Contents

Here's a comprehensive troubleshooting wiki for reNgine-ng based on the support channel discussions:

General Troubleshooting Tips

↑ Back to top

  1. Check logs:
make logs
make logs | grep celery
  1. Verify permissions:
sudo docker run --rm -v rengine_tool_config:/data alpine sh -c "ls -lh /data"
  1. Clean installation (container, volumes, images ...):
./scripts/uninstall.sh
  1. Use debug mode:
make dev_up

Common Issues and Solutions

↑ Back to top

Celery Permission Errors

Error:

celery-1 | Error: Invalid value for '-A' / '--app':
celery-1 | Unable to load celery application.
celery-1 | While trying to load the module reNgine.tasks the following error occurred:
celery-1 | PermissionError: [Errno 13] Permission denied: '/home/rengine/rengine/secret'

Solution:

# Access container as root
docker exec -it --user root rengine-celery-1 /bin/bash

# Fix permissions
chown -R rengine:rengine /home/rengine/rengine

# Exit container
exit

# Restart container
docker restart rengine-celery-1

Volume Permission Issues

Error:

PermissionError: [Errno 13] Permission denied: '/home/rengine/scan_results'

Solution:

# Fix scan_results permissions
docker exec -it --user root rengine-celery-1 /bin/bash
chown -R rengine:rengine /home/rengine/scan_results
exit

# Fix tools permissions
docker exec -it --user root rengine-celery-1 /bin/bash
chown -R rengine:rengine /home/rengine/tools
exit

Tool Configuration Issues

Error:

Error: could not find config file at /home/rengine/.config/subfinder/config.yaml

Solution:

# Create config directory
docker exec -it --user rengine rengine-celery-1 /bin/bash
mkdir -p ~/.config/subfinder/
touch ~/.config/subfinder/config.yaml
exit

# Restart celery
docker-compose restart celery

For any persistent issues, you can check the logs:

# Check web logs
docker-compose logs web

# Check celery logs
docker-compose logs celery

# Check celery beat logs
docker-compose logs celery-beat

Installation Issues

↑ Back to top

Certificate Generation Errors

Problem: Certificate generation fails during installation

Solution:

cd ./docker
docker buildx build -t ghcr.io/security-tools-alliance/rengine-ng:rengine-certs-v2.1.0 -f ./certs/Dockerfile ./certs

Celery Container Not Starting

Problem: Celery container fails to start or takes too long

Causes:

  • Permission issues with volumes
  • Wrong user/group IDs
  • Missing secret directory

Solutions:

  1. Fix volume permissions:
sudo docker run --rm -v rengine_tool_config:/data alpine sh -c "chown -R 1000:1000 /data"
sudo docker run --rm -v rengine_wordlist:/data alpine sh -c "chown -R 1000:1000 /data"
  1. Verify user has correct GID (1000)

ARM64

↑ Back to top

ARM64 Installation in v2.1.0

Problem: Installation fails due to architecture mismatch

Solution:

Build images

Prebuilt images

  • If you wanna try prebuilt-image for arm (available from install only in 2.1.1), try this command before launching install.sh with prebuilt images
docker pull ghcr.io/security-tools-alliance/rengine-ng:rengine-celery-latest@sha256:2047ddb231479b6d9f10a1a33f6883366ad9482bfc6c1518422d660fe3fd7351
docker pull ghcr.io/security-tools-alliance/rengine-ng:rengine-web-latest@sha256:9833a013af01630f4e309dcf782e18dc4cf9e66ee6e70a28caf24ba854b75b2a
docker pull ghcr.io/security-tools-alliance/rengine-ng:rengine-redis-latest@sha256:1eddcce662faede4f048d7b8ea9afb50d85c586fe582c72907f89aa15fe3183c
docker pull ghcr.io/security-tools-alliance/rengine-ng:rengine-certs-latest@sha256:4ce5d3490b09c9a4170ad04c56d857a17ada878bb0e9062be23f040af47e63e0
docker pull ghcr.io/security-tools-alliance/rengine-ng:rengine-ollama-latest@sha256:f95283b92c8d71d8b174f145116b0331c6e8d382c977381386c46d28460c378a
docker pull ghcr.io/security-tools-alliance/rengine-ng:rengine-postgres-latest@sha256:8fb1cdbbe1aeb59a65f0d9ddcfbf86b8d477b3d17be6c59496b5db91f4c3709b
docker pull ghcr.io/security-tools-alliance/rengine-ng:rengine-proxy-latest@sha256:528bd6f5a73027febd83ed9818ae41db646522e98772c21ce2a697845a4823f6
  • If, while installing, it try to download prebuilt images again, stop install tag your image with the 2.1.0 version
docker image tag ghcr.io/security-tools-alliance/rengine-ng ghcr.io/security-tools-alliance/rengine-ng:rengine-celery-v2.1.0
docker image tag ghcr.io/security-tools-alliance/rengine-ng ghcr.io/security-tools-alliance/rengine-ng:rengine-web-v2.1.0
docker image tag ghcr.io/security-tools-alliance/rengine-ng ghcr.io/security-tools-alliance/rengine-ng:rengine-redis-v2.1.0
docker image tag ghcr.io/security-tools-alliance/rengine-ng ghcr.io/security-tools-alliance/rengine-ng:rengine-certs-v2.1.0
docker image tag ghcr.io/security-tools-alliance/rengine-ng ghcr.io/security-tools-alliance/rengine-ng:rengine-ollama-v2.1.0
docker image tag ghcr.io/security-tools-alliance/rengine-ng ghcr.io/security-tools-alliance/rengine-ng:rengine-postgres-v2.1.0
docker image tag ghcr.io/security-tools-alliance/rengine-ng ghcr.io/security-tools-alliance/rengine-ng:rengine-proxy-v2.1.0
  • Launch install again and choose prebuilt, it should not download images and start container.

Scanning Issues

↑ Back to top

Empty URLs File

Problem: urls_unfurled.txt is empty causing Nuclei scans to fail

Solutions:

  • Verify scan engine configuration
  • Check target URL format (avoid www prefix)
  • Ensure subdomain discovery tools are enabled

Rate Limiting Issues

Problem: Directory fuzzing ignores rate limits

Solution:

  • Configure rate limits per tool in scan engine
  • Use recommended default values

Nuclei Scanning Problems

Problem: No vulnerabilities found or scan fails

Solutions:

  • Update Nuclei templates
# Access celery container as rengine user
docker exec -it rengine-celery-1 /bin/bash

# Update Nuclei templates
nuclei -update-templates
  • Check scan engine configuration
  • Verify target accessibility
  • Review logs for errors

Access & Security

SSL/HTTPS Issues

Problem: SSL certificate problems

Solutions:

  1. Rebuild proxy container:
cd ./docker
docker buildx build -t ghcr.io/security-tools-alliance/rengine-ng:rengine-proxy -f ./proxy/Dockerfile ./proxy
  1. Configure custom SSL certificates

Remote Access Setup

Problem: Securely accessing remote instance

Solutions:

  1. SSH Tunnel:
ssh -L 8443:localhost:443 user@rengine-ng-server -N
  1. Use WireGuard VPN
  2. Configure proper firewall rules

Version Upgrade Guide

2.0.7 to 2.1.0 Upgrade

  1. Backup .env file
  2. Switch to release branch:
git checkout release/2.1.0
git pull origin release/2.1.0
  1. Copy .env-dist to .env and update credentials
  2. Run installation:
sudo ./install.sh
  1. Fix permissions
  2. Start services:
make up

Ollama Model Download Issues

↑ Back to top

Web Interface Download Failure

Problem: Unable to download language models through the web interface

Error: Download fails or times out when trying to pull models like llama2 or codellama

Solution: Direct Docker Container Download

  1. Access the Ollama container:
docker exec -it rengine-ollama-1 bash
  1. Download the model directly using Ollama CLI:
ollama pull llama2
# or for code specific tasks
ollama pull codellama
  1. Verify model installation:
ollama list

Common Issues & Solutions

  1. Insufficient Storage
  • Check available space:
docker exec -it rengine-ollama-1 df -h
  • Clean up unused models:
ollama rm <model_name>
  1. Network Timeout
  • Download with retry:
while ! ollama pull llama2; do echo "Retrying..."; sleep 5; done
  1. Memory Constraints
  • Verify container memory limits:
docker stats rengine-ollama-1
  • Adjust memory allocation in docker-compose if needed:
services:
  ollama:
    deploy:
      resources:
        limits:
          memory: 16G
  1. Model Verification After download, test the model:
ollama run llama2 "Hello, are you working?"

Remember that model downloads can be large (several GB) and may require significant bandwidth and storage space. Always ensure your system meets the minimum requirements for the specific model you're trying to use.

⚠️ **GitHub.com Fallback** ⚠️