www.os4ed.
com
openSIS Student Information System
Installation Instructions for Community Edition
Installation on Windows
Installation on Linux
Installation on Mac
Last updated: December 2022
openSIS is a product of Open Solutions for Education, Inc.
Note: The installation creates a file "data.php" that stores necessary information for connection to the
database and default school year information. You'll need to use 777 permissions on directories where
openSIS is being installed to allow write permissions. The reason for this is, while you (your user) may own
the directories and files, another user (the web server) needs to be able to write in/to them.
Installation
openSIS Student Information System - Community Edition
Windows Installation
Installing on machines running Windows11 Desktop and Windows Server OS
openSIS requires the following pre-requisite software:
1. Apache 2.4 and above
2. MySQL 5.7, 8.0 or Maria DB 10.4.x
3. PHP 8.x
If you have installed the above-mentioned software on your computer already, you can proceed to openSIS
installation, otherwise, follow the links below to download and install the pre-requisite software.
Download and install Apache and PHP
XAMPP Windows
https://www.apachefriends.org/download.html
This will install Apache web server, MariaDB database, and PHP.
Mac Installation
XAMPP for Mac is also available from the same download
link: https://www.apachefriends.org/download.html
Make sure you log in as “root” user to your Mac and then attempt the installation.
Linux Installation
XAMPP Linux:
https://www.apachefriends.org/download.html
This will install Apache web server, MySQL/Maria DB database, and PHP 8.x.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 2
openSIS is a product of Open Solutions for Education, Inc.
openSIS Installation
This installation assumes that you have installed and properly configured the following items:
▪ Web Server (Apache is the webserver we test on and use)
▪ MySQL/Maria DB database software
▪ PHP
We recommend that you use one of the automated installers like XAMPP which eases the process of
installing and configuring the webserver.
Open your php.ini file and search for display_errors = ON and change it to display_errors = Off
Automated Installation
openSIS includes an automated installer that has been extensively tested on Windows and Ubuntu Linux.
1. Download the latest stable release of openSIS from the https://github.com/OS4ED/openSIS-
Classic/releases
2. Unzip the openSIS folder to your webserver directory.
In case you installed XAMPP the webserver directory will be:
<XAMPP Installation Directory>/htdocs/
3. Open your web browser and go to the following address:
http://localhost/opensis-ce (or whatever the folder name you have used during unzipping the code)
Click on New Installation to continue, the automated installer will guide you through the setup step by
step.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 3
openSIS is a product of Open Solutions for Education, Inc.
The installer will check system requirements for the pre-requisites and if it finds it will prompt you to
continue.
After you click continue, in the database connection step you will be asked to provide MySQL/Maria DB
connection information. Keep the Server Input field as “localhost”. openSIS is designed to be installed on
localhost or on any MySQL/Maria DB server where you (the user) have read write permission. openSIS
does not install on many shared hosting sites because the host does not provide “write” access to
database which is required to install stored procedures.
Provide the admin username and password for the database so the application can connect to it.
Note: Remember that if you provided the wrong details for MySQL/Maria DB connection, you will be
redirected to an error page like the one below. Click “Try Again” and provide the correct connection
information.
Once you have provided the database connection, we move to the database creation step where you will
need to enter the name for the database you want to use for openSIS. The system defaults to openSIS;
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 4
openSIS is a product of Open Solutions for Education, Inc.
you can leave it as is or give a different name.
If you already have created a database and trying to install it again, then check the “Remove data from an
existing database” option to remove the old database.
Provide the school name, begin date and end date of the school year that you are creating. You can also
check the “Install with sample school data” option to install the sample school. The data in the sample
school will act as a guide to help you configure your own school properly.
In account setup, enter Administrator’s First Name, Last Name, Email ID, Username and Password you
would like to use for administering openSIS. The Password must have a number and special character.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 5
openSIS is a product of Open Solutions for Education, Inc.
Finally, you have your application set up and ready to use. Click on the proceed to openSIS login button
and login to the application using the administrator Username/Password you provided during installation in
the account setup.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 6
openSIS is a product of Open Solutions for Education, Inc.
Congratulations! You have successfully installed openSIS.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 7
openSIS is a product of Open Solutions for Education, Inc.
If you are trying to upgrade then click on Upgrade to continue from the installation screen, the automated
upgrade will guide you through the setup step by step.
Check the openSIS version beforehand to proceed. If it is version 7.1 and above, then click on continue,
else click on go back.
Just like performing a new installation, for an upgrade you will be asked to provide MySQL/Maria DB
connection information. Keep the Server Input field as “localhost”. openSIS is designed to be installed on
localhost or on any MySQL/Maria DB server where you (the user) have read write permission. openSIS
does not install on many shared hosting sites because the host does not provide “write” access to
database which is required to install stored procedures.
Provide the admin username and password for the database so the application can connect to it.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 8
openSIS is a product of Open Solutions for Education, Inc.
You'll need to select the database that you want to upgrade from and click on save & next.
Upgrade will begin processing and on successful upgrade, click on Login to start using openSIS.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 9
openSIS is a product of Open Solutions for Education, Inc.
Note:
As a security measure, the install folder will be deleted automatically after the installation. If you need to re-
install openSIS, please unzip the downloaded file again, or re-download openSIS from
https://github.com/OS4ED/openSIS-Classic/releases.
If you need assistance with installation, configuration, data import or anything else, please purchase
support from https://www.os4ed.com/purchase-support.
New Product:
If you do not want the hassle of installing and managing openSIS yourself, you can subscribe to the
beautifully designed openSIS SaaS product. No download is required. Cloud hosted at Microsoft Azure,
secure and scalable with 99.9% uptime guarantee.
Visit opensis.com and start your 15-day free trial. No credit card required. Affordable pricing.
Copyright © Open Solutions for Education, Inc. All Rights Reserved. Page 10
