This guide provides comprehensive instructions for setting up and running the Prutan Enterprise environment using Docker. It covers prerequisites, environment configuration, container deployment, verification steps, and licensing requirements for enterprise users.

Prutan Environment Setup

Prerequisites

Before running the Docker container, ensure the following:

  • Docker Installed: Install Docker on your machine. You can download it from Docker's official site.
  • Pull Prutan latest image from ECRdocker pull public.ecr.aws/k9h2c3x0/prutan-pub/combined:latest
  • Database Setup: A MySQL database must be running and accessible.
  • Email SMTP Configuration: Ensure valid SMTP credentials for email notifications.
  • Network Configuration: Ensure required ports are open and available i.e. 8080
  • Minimum host machine requirements:
    • vCPUs - 2
    • RAM (GiB) - 4

1. Running the Unified Prutan Service

Environment Variables

To configure the Prutan services, create an .env file with the following variables for both Core and Agent components:

DB Type : MySQL

# For prutan-core
db_type=MySQL
log_level_core=INFO
http_port_core=8080 //http_port_core
db_ip=<replace_with_db_ip>
db_port=3306
db_user=<replace_with_db_user>
db_password=<replace_with_db_password>
db_schema=<replace_with_db_schema>
mail_host=smtp.dummydomain.com
mail_port=587
mail_username=dummyuser
mail_password=dummypassword
router=true

# For prutan-executor
log_level_executor=INFO
http_port_executor=9090  //http_port_executor
referer=http://127.0.0.1:9090/prutan/exec
endpoint=http://127.0.0.1:8080/prutan/core/
is_remote=true
is_default=true
is_persistence=true
machine_name=PrutanAgent

# ssl files(To Start the application in SSL mode)
server_keystore=/usr/local/prutan/certs/app-server-keystore.p12 //optional
ca_truststore=/usr/local/prutan/certs/ca-truststore.p12 //optional
ssl_port=9333

DB Type : sqlserver

# For prutan-core
db_type=sqlserver
log_level_core=INFO
http_port_core=8080  // http_port_core
db_ip=<replace_with_db_ip>
db_port=1433
db_user=<replace_with_db_user>
db_password=<replace_with_db_password>
db_schema=<replace_with_db_schema>
mail_host=smtp.dummydomain.com
mail_port=587
mail_username=dummyuser
mail_password=dummypassword
router=true

# For prutan-executor
log_level_executor=INFO
http_port_executor=9090    // http_port_executor>
referer=http://127.0.0.1:9090/prutan/exec
endpoint=http://127.0.0.1:8080/prutan/core/
is_remote=true
is_default=true
is_persistence=true
machine_name=PrutanAgent

# ssl files(To Start the application in SSL mode)
#server_keystore=/usr/local/prutan/certs/app-server-keystore.p12 //optional
#ca_truststore=/usr/local/prutan/certs/ca-truststore.p12 //optional
ssl_port=9333

Running the Docker Container

Once the .env file is created, use the following command to start the container securely:


docker run -d \
  --name prutan-single \
  --memory='4g' \
  --memory-swap='4g' \
  -p 8080:8080 \                 
  -p 8000-8050:8000-8050 \       
  -p 9333:9333 \                
  -v /root/test_certificates/certs:/usr/local/prutan/certs \  
  --env-file .env \              
  public.ecr.aws/k9h2c3x0/prutan-pub/combined:latest
  • --name prutan-single // container name
  • --memory='4g' // Limits RAM to 4GB
  • --memory-swap='4g' // Sets swap space equal to RAM (4GB)
  • -p 8080:8080 // Core service port
  • -p 8000-8050:8000-8050 // Port range for ISO collections (Hostbox & Interceptor)
  • -p 9333:9333 // SSL port (if enabled in config)
  • -v /root/test_certificates/certs:/usr/local/prutan/certs // Certificate path
  • --env-file .env // Environment variables file
  • public.ecr.aws/k9h2c3x0/prutan-pub/combined:latest #Image URI

2. Verification

  • Check Running Containers:
docker ps
  • View Logs:
docker logs -f prutan-develop
  • Access Prutan web UI:
 https://app.prutan.com/prutan/core/ui/#/home/collections

After application startup you should see following screen:

3. Stopping and Removing the Container

docker stop prutan
docker rm prutan

4. Prutan License

Prutan requires a license to access any module. After installation, please email info@intellocore.com to obtain the license.