kwabena-aboah/sikaba_systems

Sikaba Systems delivers affordable, purpose-built software for payroll, health, education, agriculture and community management — fully localised for Ghanaian and African organisations. # Sikaba Systems – Namecheap Deployment Guide ## Prerequisites - Namecheap shared hosting with cPanel - Python 3.9+ enabled (Setup Python App in cPanel) - MySQL database created in cPanel - Domain pointed to your hosting --- ## Step 1 – Upload Your Project Upload the entire `sikaba_systems/` folder to your cPanel home directory (e.g. `/home/yourusername/sikaba_systems/`). You can use: - cPanel File Manager - FTP (FileZilla) - SSH: `scp -r sikaba_systems/ user@yourserver.com:~/` --- ## Step 2 – Create Python Virtual Environment in cPanel 1. Login to cPanel → **Setup Python App** 2. Click **Create Application** 3. Set: - Python version: `3.9` (or highest available) - Application root: `sikaba_systems` - Application URL: your domain - Application startup file: `passenger_wsgi.py` 4. Click Create cPanel creates a virtualenv at `~/virtualenv/sikaba_systems/` --- ## Step 3 – Install Dependencies In cPanel Terminal (or SSH): ```bash cd ~/sikaba_systems source ~/virtualenv/sikaba_systems/bin/activate pip install -r requirements.txt pip install mysqlclient # for MySQL support ``` --- ## Step 4 – Create MySQL Database in cPanel 1. cPanel → **MySQL Databases** 2. Create database: `yourusername_sikabadb` 3. Create user: `yourusername_dbuser` with a strong password 4. Add user to database with ALL PRIVILEGES --- ## Step 5 – Configure Environment ```bash cd ~/sikaba_systems cp .env.example .env nano .env # or use cPanel File Manager to edit ``` Fill in: ``` SECRET_KEY=generate-a-50-char-random-string DEBUG=False ALLOWED_HOSTS=yourdomain.com,www.yourdomain.com DB_ENGINE=django.db.backends.mysql DB_NAME=yourusername_sikabadb DB_USER=yourusername_dbuser DB_PASSWORD=your_db_password DB_HOST=localhost PAYSTACK_PUBLIC_KEY=pk_live_your_key PAYSTACK_SECRET_KEY=sk_live_your_key PAYSTACK_CALLBACK_URL=yourdomain.com EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend EMAIL_HOST=mail.yourdomain.com EMAIL_HOST_USER=info@yourdomain.com EM …