System Requirements

Overview

Before installing the KiviCare Webhook Addon, ensure your system meets these requirements for optimal performance and compatibility.

---

Minimum Requirements

KiviCare Requirements

Component	Requirement
KiviCare Version	3.0.0 or higher
KiviCare License	Active KiviCare Pro license
KiviCare Modules	Core modules installed

WordPress Requirements

Component	Requirement
WordPress Version	6.0 or higher
WordPress Multisite	Supported
Admin Access	Required for installation

PHP Requirements

Component	Requirement
PHP Version	8.0 or higher
PHP Extensions	cURL, JSON, OpenSSL
Memory Limit	256MB minimum (512MB recommended)
Max Execution Time	60 seconds minimum
Upload Max Filesize	64MB minimum

---

Server Requirements

Web Server

Supported:

• Apache 2.4+
• Nginx 1.18+
• LiteSpeed 5.4+

Required Modules:

• mod_rewrite (Apache)
• URL rewriting enabled

Database

Component	Requirement
MySQL	5.7 or higher
MariaDB	10.3 or higher
Database Size	Additional 10MB for webhook tables

Network

Component	Requirement
Outbound HTTPS	Enabled (required for webhooks)
Firewall	Allow outbound connections on port 443
SSL/TLS	Support for TLS 1.2+

---

External Endpoint Requirements

Your webhook endpoints must meet these requirements:

Accessibility

✅ Publicly accessible URL (not localhost in production)
✅ Valid domain name or IP address
✅ Reachable from your server

Performance

✅ Response time < 30 seconds
✅ Stable uptime (99%+ recommended)
✅ Handle concurrent requests

Security

✅ Valid SSL certificate (for HTTPS endpoints)
✅ Support authentication (recommended)
✅ Accept POST/PUT/PATCH requests

---

Recommended Specifications

For Small Clinics (< 100 appointments/day)

Server:

• 2 CPU cores
• 4GB RAM
• 20GB SSD storage
• 100 Mbps network

Webhooks:

• Up to 10 active webhooks
• Basic monitoring
• Standard logging

For Medium Clinics (100-500 appointments/day)

Server:

• 4 CPU cores
• 8GB RAM
• 50GB SSD storage
• 1 Gbps network

Webhooks:

• Up to 25 active webhooks
• Enhanced monitoring
• Extended logging (90 days)

For Large Clinics (500+ appointments/day)

Server:

• 8+ CPU cores
• 16GB+ RAM
• 100GB+ SSD storage
• 1 Gbps+ network

Webhooks:

• Unlimited active webhooks
• Advanced monitoring
• Custom log retention

---

Hosting Provider Compatibility

Verified Compatible

✅ SiteGround – Fully supported
✅ WP Engine – Fully supported
✅ Kinsta – Fully supported
✅ Cloudways – Fully supported
✅ AWS – Fully supported
✅ DigitalOcean – Fully supported
✅ Linode – Fully supported

May Require Configuration

⚠️ Shared Hosting – May need outbound HTTPS enabled
⚠️ Managed WordPress – Check firewall rules
⚠️ Budget Hosting – Verify PHP version and extensions

Not Recommended

❌ Free Hosting – Insufficient resources
❌ Very Cheap Shared Hosting – Performance issues
❌ Localhost – For development only

---

Browser Requirements

For Admin Dashboard

Supported Browsers:

• Chrome 90+
• Firefox 88+
• Safari 14+
• Edge 90+

Not Supported:

• Internet Explorer (any version)
• Opera Mini
• UC Browser

---

PHP Extension Details

Required Extensions

cURL

# Check if installed
php -m | grep curl

# Install on Ubuntu/Debian
sudo apt-get install php-curl

# Install on CentOS/RHEL
sudo yum install php-curl

JSON

# Check if installed
php -m | grep json

# Usually included by default

OpenSSL

# Check if installed
php -m | grep openssl

# Install on Ubuntu/Debian
sudo apt-get install php-openssl

Recommended Extensions

Mbstring – For character encoding
XML – For data processing
GD – For image handling
Zip – For backups

---

Checking Your System

WordPress Site Health

1. Go to WordPress Admin → Tools → Site Health
2. Click Info tab
3. Check:

• WordPress version
• PHP version
• Database version
• Active plugins

PHP Configuration

Create a file phpinfo.php in your WordPress root:

<?php
phpinfo();
?>

Visit https://yoursite.com/phpinfo.php and check:

• PHP version
• Loaded extensions
• Memory limit
• Max execution time

⚠️ Delete this file after checking!

Server Connectivity Test

Test outbound HTTPS:

curl -I https://www.google.com

Should return HTTP 200 response.

---

Common Issues & Solutions

Issue: Outbound HTTPS Blocked

Symptoms:

• Webhooks timeout
• Connection errors
• No response from endpoints

Solutions:

1. Contact hosting provider
2. Request outbound HTTPS on port 443
3. Whitelist destination domains
4. Check firewall rules

Issue: PHP Version Too Old

Symptoms:

• Plugin won’t activate
• Fatal errors
• Compatibility warnings

Solutions:

1. Update PHP via hosting control panel
2. Contact hosting support
3. Consider upgrading hosting plan

Issue: Memory Limit Too Low

Symptoms:

• White screen of death
• Plugin crashes
• Incomplete operations

Solutions:

1. Increase in wp-config.php:

define('WP_MEMORY_LIMIT', '256M');

2. Or in .htaccess:

php_value memory_limit 256M

3. Contact hosting support

---

Performance Optimization

Server-Side

✅ Enable OPcache

opcache.enable=1
opcache.memory_consumption=128

✅ Use PHP-FPM

• Better performance than mod_php
• Lower memory usage

✅ Enable Gzip Compression

<IfModule mod_deflate.c>
  AddOutputFilterByType DEFLATE text/html text/plain text/xml
</IfModule>

WordPress-Side

✅ Use Caching Plugin

• WP Rocket
• W3 Total Cache
• WP Super Cache

✅ Optimize Database

• Regular cleanup
• Remove post revisions
• Optimize tables

✅ Use CDN

• CloudFlare
• StackPath
• KeyCDN

---

Security Requirements

SSL Certificate

Required for:

• Webhook endpoints (HTTPS)
• WordPress admin (recommended)
• Patient data protection

Options:

• Let’s Encrypt (free)
• Commercial SSL
• Wildcard SSL (multi-domain)

Firewall

Recommended:

• Web Application Firewall (WAF)
• DDoS protection
• Rate limiting

Providers:

• CloudFlare
• Sucuri
• Wordfence

---

Upgrade Considerations

From Older KiviCare Versions

Before Upgrading:

1. Backup database
2. Backup files
3. Test on staging site
4. Check plugin compatibility

After Upgrading:

1. Verify webhooks still work
2. Check execution logs
3. Test critical integrations
4. Monitor for 24 hours