Complete step-by-step guide to install and configure your institution's verification portal
Follow these steps in order to deploy your BacChecker portal. Each step includes the exact commands to run.
Use this configuration for /etc/nginx/sites-available/bacchecker-gov
server {
listen 80;
listen [::]:80;
server_name verify.yourinstitution.gov.gh;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name verify.yourinstitution.gov.gh;
root /var/www/bacchecker-gov/public;
# SSL Configuration
ssl_certificate /etc/letsencrypt/live/verify.yourinstitution.gov.gh/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/verify.yourinstitution.gov.gh/privkey.pem;
ssl_protocols TLSv1.3 TLSv1.2;
ssl_ciphers HIGH:!aNULL:!MD5;
# Security Headers
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Strict-Transport-Security "max-age=31536000" always;
index index.php;
charset utf-8;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all;
}
}Configure these variables in your .env file
APP_NAME="Your Institution Name"
APP_ENV=production
APP_KEY=base64:... # Generated by artisan key:generate
APP_DEBUG=false
APP_URL=https://verify.yourinstitution.gov.gh
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bacchecker_gov
DB_USERNAME=bacchecker
DB_PASSWORD=your_secure_password
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=smtp
MAIL_HOST=your-mail-server
MAIL_PORT=587
MAIL_USERNAME=your-email@institution.gov.gh
MAIL_PASSWORD=your-mail-password
MAIL_ENCRYPTION=tls
# Central Gateway Configuration
GATEWAY_API_URL=https://api.bacchecker.gov.gh/api/v1
GATEWAY_API_KEY=your_api_key_from_gateway
GATEWAY_API_SECRET=your_api_secret_from_gatewayYour BacChecker portal is now installed. Next, complete the 8-step configuration wizard to set up your institution.