PihuPulse Installation Guide

Prerequisites

Before installing PihuPulse, ensure your system meets the following requirements:

Cloud Installation

Our cloud-based solution is the quickest way to get started with PihuPulse. Follow these steps to set up your cloud instance:

1. 1Sign Up for PihuPulse Cloud

   Visit our signup page and create your account. Choose the plan that best fits your organization's needs.

2. 2Configure Your Instance

   After signing up, you'll be guided through the initial setup process. This includes setting up your company profile, defining user roles, and configuring basic preferences.

3. 3Domain Setup (Optional)

   For Enterprise plans, you can set up a custom domain for your PihuPulse instance (e.g., recruit.yourcompany.com). Follow the DNS configuration instructions provided in your admin dashboard.

4. 4Set Up Integrations

   Connect PihuPulse to your existing HR systems, such as your ATS, HRIS, or calendar tools. Detailed integration guides are available in the admin dashboard.

5. 5Invite Team Members

   Add your team members to the platform by navigating to Settings > Team Management and sending invitation emails.

PihuPulse Cloud Dashboard

On-Premise Installation

For organizations with specific security or compliance requirements, PihuPulse offers an on-premise solution that can be installed on your own servers.

Installation Steps

1. 1Database Setup

   Set up your PostgreSQL or MySQL database and create a new database for PihuPulse:

   # For PostgreSQL
CREATE DATABASE pihupulse;
CREATE USER pihupulse_user WITH PASSWORD 'your_secure_password';
GRANT ALL PRIVILEGES ON DATABASE pihupulse TO pihupulse_user;

   Make note of your database credentials as you'll need them during the installation process.

2. 2Install PihuPulse

   Run the installer package and follow the on-screen instructions. When prompted, enter your database connection details.

   # Linux/macOS
chmod +x pihupulse-installer.sh
./pihupulse-installer.sh

# Windows
# Simply run the pihupulse-installer.exe file

3. 3Configure Web Server

   Set up Nginx or Apache to serve your PihuPulse application. Here's a sample Nginx configuration:

   server {
  listen 80;
  server_name your-domain.com;

  location / {
    proxy_pass http://localhost:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
  }
}

4. 4SSL Configuration

   For secure connections, set up SSL certificates using Let's Encrypt or your preferred certificate provider. Update your web server configuration to use HTTPS.

5. 5Start PihuPulse Services

   Start the PihuPulse application and ensure it runs on system startup:

   # Using systemd (Linux)
sudo systemctl start pihupulse
sudo systemctl enable pihupulse

# Using the service manager (Windows)
net start PihuPulse

Docker Installation

For a containerized deployment, PihuPulse provides official Docker images that can be easily deployed using Docker Compose.

1. 1Clone the Repository

   git clone https://github.com/pihupulse/docker-deployment.git
cd docker-deployment

2. 2Configure Environment Variables

   Create a .env file based on the provided template:

   cp .env.example .env
# Edit the .env file with your configuration

   Update the database credentials, application settings, and other environment-specific variables in the .env file.

3. 3Start the Containers

   docker-compose up -d

   This command will pull the necessary images and start the PihuPulse application, database, and other required services.

4. 4Configure Reverse Proxy

   Set up a reverse proxy (Nginx or Traefik) to handle SSL termination and route traffic to your Docker containers. Sample configurations are provided in the repository.

Installation Verification

After completing the installation, verify that PihuPulse is running correctly by following these steps:

1. 1Access the Web Interface

   Open your browser and navigate to your PihuPulse URL (e.g., https://your-domain.com or http://localhost:3000 for local installations). You should see the login page.

2. 2Create Admin Account

   For new installations, you'll be prompted to create an administrator account. Follow the on-screen instructions to set up your admin credentials.

3. 3Run Health Check

   Access the system health check page to verify all components are functioning correctly:

   https://your-domain.com/admin/health-check

   All services should show a "Healthy" status. If any component shows an error, check the logs for more information.

4. 4Test AI Capabilities

   Create a test screening and run through the candidate experience to ensure the AI components are working correctly. This will verify that the natural language processing and candidate evaluation features are functioning as expected.

Troubleshooting

If you encounter issues during installation, here are some common problems and their solutions:

For additional troubleshooting assistance, consult our detailed logs: