How to install Sakai 22 on Mac OS

Owned by kunaljaykam, created
Last updated: Apr 27, 2023 by Sam Ottenhoff
3 min read

This quick guide will help you to run Sakai locally on your system.

 Instructions

Requirements

Java-11(JDK)
maven-3.6
tomcat-9
MySQL-8 or MariaDB-latest

 

 

  1. Download Java-11

You can also download the open JDK version from this link, But its easier to find the path of Oracle JDK (i.e Library/Java/JavaVirtualMachines/your jdk version )

 

2. Download Maven-3.6

 

3. Move Maven to the application folder

$ cd Downloads/ # move apache maven to the applications folder $ mv apache-maven-3.6.3 /Applications/

 

4. Set up the paths for Maven and Java

# check if you already have a .zshrc file, (if not create one $touch .zshrc) # to check whether it exists or not $ ls -a # now open the file $ open -e .zshrc # set maven path(copy and paste the below to your .zshrc file) export MAVEN_HOME=/Applications/apache-maven-3.6.3 export PATH=$PATH:$MAVEN_HOME/bin export MAVEN_OPTS='-Xms1024m -Xmx2048m' # set java path export JAVA_HOME=/Library/Java/JavaVirtualMachines/your jdk file name/Contents/Home export PATH=$JAVA_HOME/bin:$PATH

After saving the .zshrc file, restart your terminal. And Verify If its working

java --version for java, and mvn --version for maven. If all seems good, then follow the next steps.

 

5. Install MySQL

# Install brew, ignore if you have brew installed $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Install mysql $ brew install mysql $ brew services start mysql # setup the root passowrd, {0,root password=root1234 and Y to all} $ mysql_secure_installation # restart mysql server $ brew services restart mysql

Set up the MySQL for Sakai to use

 

6. Almost done, Create a directory for Sakai

Now paste all of the below codes inside sakai.properties

Save the file.

 

7. Download the latest apache-tomcat

extract the tomcat in the sakai-workspace folder and rename the apache-tomcat as tomcat9

Add the below code snippet to the <Context> block of the tomcat9/conf/context.xml

Now, create a file name setevn.sh in tomcat9/bin directory and paste the below code snippets.

One last step inside tomcat9 directory

 

8. Final Step, time to clone the Sakai git repository:

After the build is complete

 

Congratulation , Here’s your Sakai http://127.0.0.1:8080/portal

 

 

 

If you get stuck or need more help, email us here: sakai-dev@apereo.org