Windows¶
- Download the KA Lite Windows installer.
- Double-click the downloaded .exe file, and the wizard window will appear to guide you through the process of installing KA Lite on your server.
Mac/OSX¶
- Download the KA Lite OSX installer.
- After the download is complete, double click the .dmg file.
- On the .dmg window, drag the “KA-Lite Monitor” app into the “Applications” folder.
- Launch “KA-Lite Monitor” from your ‘Applications’ folder.
- On first load, it will check your current environment and show the Preferences dialog.
- Input your preferred admin username and password.
- Click on the Apply button.
- You will be prompted that initial setup will take a few minutes, click the “OK” button and wait for the notification that KA-Lite has been setup and can now be started.
- Click on the KA-Lite logo icon on the Status Menu Bar and select the “Start KA-Lite” menu option.
- When prompted that KA-Lite has been started, click on the logo icon again and select “Open in Browser” menu option - this should launch KA-Lite on your preferred web browser.
- Login using the administrator account you have specified during setup.
Linux¶
Main method: Ubuntu/Debian .deb¶
Download the latest .deb manually from our server. After that, you can install the .deb file like this:
sudo dpkg -i FILENAME.deb
FILENAME
should be replaced with the name of the file you downloaded.
The file may be named as if it was intended for Ubuntu but works just as well for any other Debian-based systems like
Debian, Raspberry Pi, Linux Mint etc.
You will be prompted to enter some configuration information. You should read the on-screen instructions carefully, but some explanation is included here:
1. You will asked to choose to run KA Lite on boot or not. We recommend choosing yes, as it simplifies data management. If you choose no, you must manually start KA lite every time. Note that running KA Lite as different users creates different sets of data files, so it’s recommended that you run KA Lite as the same user every time.

2. If you chose to start on boot in the previous step, you will be prompted to choose the owner for the KA Lite server process. Generally the default value is ok.

- You will be asked to review your choices, and finally KA Lite will start automatically when installation is complete.
Tip
If you want to receive automatic updates from online sources, you can also use Debian/Ubuntu: Subscribe to updates through a PPA.
Raspberry Pi¶
For a Raspberry Pi running a Debian system, you can install the special Debian
package ka-lite-raspberry-pi
.
It can be installed by downloading the latest .deb on the Pi and installing it:
# Install dependencies
sudo apt-get install python-m2crypto python-pkg-resources nginx python-psutil
# Fetch the latest .deb
sudo wget https://learningequality.org/r/deb-pi-installer-0-14
# Install the .deb
sudo dpkg -i ka-lite-raspberry-pi*.deb
You can also add the PPA, see Debian/Ubuntu: Subscribe to updates through a PPA, and then
run sudo apt-get install ka-lite-raspberry-pi
.
After installing, you can setup a Wifi hotspot using this guide: Raspberry Pi Wi-Fi
Other options¶
KA Lite is available for all platforms (e.g. non-Debian compatible platforms) through PyPi. See Generic installation (pip install).
Configuration after installation or update¶
Every time you install or update KA Lite, you must run kalite manage setup
command again to setup the database and download assessment items (video descriptions,
exercises etc.).
Uninstalling¶
Windows¶
- Uninstall KA Lite from the Control Panel.
- In Windows XP, double-click the “Add or Remove Programs” icon, then choose KA Lite.
- In later version of Windows, click the “Programs and Features” icon, then choose KA Lite.
Mac OSX¶
- Launch
KA-Lite Monitor
from yourApplications
folder. - Click on
Preferences
in the menu option. - Click the
Reset App
from TheAdvanced
- You will be prompted that “this will reset app. Are you sure?”, just click on
OK
button. - Another dialog will appear asking your
Password
just click onCancel
button. - Quit the
KA-Lite Monitor
app. - Move
KA-Lite Monitor
app toTrash
.
Linux: Debian/Ubuntu¶
Option 1: Open up Ubuntu Software Center and locate the KA Lite package.
Press Remove
.
Option 2: Use apt-get remove <name of package>
. You have to know which
package you installed, typically this is ka-lite
or ka-lite-bundle
.
Installed with pip¶
You can remove KA Lite (when installed from pip or source distribution) with
pip uninstall ka-lite
or pip uninstall ka-lite-static
(static version).
Removing user data¶
Some data (like videos and language packs) are downloaded into a location that depends on the user running the KA Lite server. Removing that directory can potentially reclaim lots of hard drive space.
On Windows, the HOME and USERPROFILE registry values will be used if set,
otherwise the combination %HOMEDRIVE%%HOMEPATH%
will be used.
You can check these values from the command prompt using the commands
echo %HOME%
, echo $USERPROFILE%
, etc.
Within that directory, the data is stored in the .kalite
subdirectory.
On most versions of Windows, this is C:\Users\YourUsername\.kalite\
.
On Linux, OSX, and other Unix-like systems, downloaded videos and database files are in ~/.kalite
.