Skip to content

Installation Guide

Get DEEPS up and running on your system for testing and evaluation.

Experimental System Notice

DEEPS is currently in development/testing phase. Use only with dummy data. You are responsible for your own data security and handling. This is a personal research project exploring academic data processing approaches.

Download DEEPS

Current Version: v2.1

DEEPS is available for all major operating systems. Choose your platform below:

System Requirements: - Windows 10 or later (64-bit) - 4 GB RAM (8 GB recommended) - 2 GB available disk space - Administrator privileges for installation

Download Options:

System Requirements: - macOS 10.15 (Catalina) or later - Intel or Apple Silicon processor - 4 GB RAM (8 GB recommended) - 2 GB available disk space

Download:

Download for macOS (.dmg)

System Requirements: - Ubuntu 18.04+ / CentOS 7+ / Fedora 30+ - 4 GB RAM (8 GB recommended) - 2 GB available disk space - Python 3.8+ (usually pre-installed)

Download Options:

Installation Steps

Windows Installation

  1. Download the Windows installer (.msi file)
  2. Right-click the installer and select "Run as administrator"
  3. Follow the setup wizard:
  4. Accept the license agreement
  5. Choose installation location (default recommended)
  6. Select components to install
  7. Complete installation and restart if prompted
  8. Launch DEEPS from the Start menu or desktop shortcut

Installation Tips

  • Temporarily disable antivirus during installation if prompted
  • Choose "Install for all users" for multi-user environments
  • Keep the default installation path for automatic updates

macOS Installation

  1. Download the macOS disk image (.dmg file)
  2. Open the downloaded .dmg file
  3. Drag DEEPS to the Applications folder
  4. Launch DEEPS from Applications
  5. Allow the app when macOS security prompts appear

Security Notice

On first launch, you may see "DEEPS cannot be opened because it is from an unidentified developer":

  • Right-click DEEPS in Applications
  • Select "Open" from the context menu
  • Click "Open" in the security dialog

Linux Installation

  1. Download the AppImage file
  2. Make it executable: chmod +x DEEPS-v2.1-x86_64.AppImage
  3. Run: ./DEEPS-v2.1-x86_64.AppImage

Option 2: Debian Package

  1. Download the .deb package
  2. Install: sudo dpkg -i deeps_2.1_amd64.deb
  3. Resolve dependencies: sudo apt-get install -f
  4. Launch: deeps or find in applications menu

Post-Installation Setup

First Launch

When you start DEEPS for the first time:

  1. License Verification - DEEPS will attempt to verify your educational license
  2. Institution Setup - Configure your institution's details
  3. Database Initialization - Create the local database structure
  4. User Account - Set up the first administrator account

Verify Installation

Test your DEEPS installation:

  • [ ] Application launches without errors
  • [ ] License verification completes successfully
  • [ ] You can access the main interface
  • [ ] Sample data can be imported (optional test)

Network Configuration

License Verification Requirements

DEEPS requires internet access for initial license verification:

  • Outbound HTTPS (port 443) for updates
  • No inbound ports required
  • Proxy support available for corporate networks

Data Directory Setup

Default Locations

DEEPS stores data in these default locations:

C:\Users\[Username]\Documents\DEEPS\
├── databases/          # Student data (local only)
├── exports/           # Generated reports
├── imports/           # Excel file workspace
└── backups/           # Automatic backups

~/Documents/DEEPS/
├── databases/          # Student data (local only)
├── exports/           # Generated reports
├── imports/           # Excel file workspace
└── backups/           # Automatic backups

~/Documents/DEEPS/
├── databases/          # Student data (local only)
├── exports/           # Generated reports
├── imports/           # Excel file workspace
└── backups/           # Automatic backups

Custom Data Location

For institutional deployments, you can specify custom data directories:

  1. Settings → Preferences → Data Storage
  2. Choose network drive or shared storage location
  3. Ensure all users have read/write access
  4. Configure automatic backups to secure location

Multi-User Setup

Shared Installation

For multiple users accessing the same data:

  1. Install DEEPS on each user's computer
  2. Configure shared network storage for databases
  3. Set up user accounts with appropriate permissions
  4. Test concurrent access (read-only for most users)

Access Control

Configure user permissions:

  • Administrator - Full access to all features
  • Academic Staff - Process exams, generate reports
  • Registrar - Access student records, create transcripts
  • Read-Only - View reports, export data

Troubleshooting Installation

Common Issues

Installation Fails on Windows: - Run installer as Administrator - Temporarily disable antivirus software - Check available disk space (minimum 2 GB)

macOS Security Blocks App: - Right-click app, select "Open" - Check System Preferences → Security & Privacy - Allow app from "unidentified developer"

Linux Dependencies Missing: - Update package manager: sudo apt update - Install Python 3.8+: sudo apt install python3 - Install required libraries: sudo apt install python3-tk

License Verification Fails: - Check internet connectivity - Verify institutional firewall settings - Contact samuel.macharia@dkut.ac.ke for assistance

Getting Help

If you encounter installation issues:

  1. Check the Troubleshooting Guide
  2. Review Frequently Asked Questions
  3. Contact samuel.macharia@dkut.ac.ke for assistance

Next Steps

Once DEEPS is installed successfully:

  1. System Requirements - Verify your system is optimized
  2. First Setup - Configure DEEPS for your institution
  3. User Guide - Learn to use DEEPS effectively

Installation complete? Proceed to System Requirements to optimize your setup.