Skip to main content

Minga IT Guide: Setting up Minga for Your School or District

How to configure security, establish data integrations, and launch automatic rostering from start to finish.

This guide is designed for IT professionals and school administrators to centralize their school's tech stack within Minga. By following these steps, you will establish a secure environment, connect your Student Information System (SIS), and automate daily operations like attendance and hall passes. This process typically involves six core configuration phases.

Permission Level Required: Owner | District Manager | District IT Administrator

⚠️ Before you begin: Ensure you have administrative access to your school's Student Information System (SIS) and your district's web filtering or firewall settings.

In this Guide:

For a shareable PDF version of this guide, click the button below:

Minga IT Guide PDF

Whitelisting and Security

Before users can access the platform, you must ensure your network allows traffic from Minga's domains and recognizes the mobile application IDs.

  • Navigate to your district's Web Filter or Firewall settings.

  • Add *.minga.io to your allowed domains list.

  • Whitelist the following App IDs for mobile device management:

    • Apple AppStore ID: 1376350263

    • Google PlayStore ID: io.minga.app.android

Data Residency

All data resides in the United States and is hosted in partnership with Google.

Safety & Security of Student Data

Minga meets United States federal and state standards for data collection, storage, usage, and sharing of personal data. We never collect unnecessary information, and we never share it for any reason outside of your school or district, including names or email addresses.

Additional Resources

Authentication and SSO

Configuring SSO reduces credential risk and simplifies access by allowing users to log in with their existing district credentials.

Step-by-step Guide to Setting up Single Sign-On (SSO)

  1. Select your district's preferred SSO Method from the following supported providers:

    • Google

    • Microsoft

    • Clever

    • ClassLink

  2. Follow the provider-specific prompts to authorize Minga to authenticate your users.

    • If your school does not use SSO, users may log in using an Email and Password.

SIS Integration and Rostering

MingaSync connects directly to your SIS to automate the creation of accounts for students, parents, and staff every night.

Step-by-step Guide to Setting up Automatic Rostering

  1. Identify if your SIS is OneRoster-compatible for a direct connection (e.g., PowerSchool, Infinite Campus, Skyward etc)

  • Clever CSV

  • OneRoster 1.1 CSV. Mandatory CSV Files: For SFTP rostering, only six mandatory CSV files are required. These include:

  • Schools

  • Users (first name, last name, school email, student ID, grade level, role)

  • Courses and classes/sections

  • Enrollments

  • Master schedule (periods, time blocks, room numbers)

  • Academic sessions and terms. Providing these datasets ensures that features like FlexTime and Check In are enabled in Minga.

2. Go through the self-serve rostering flow in your Minga app.

  • Enter your IT contact's name and email address in the field provided under People>Rostering.

  • Share your API Endpoint URL, token endpoint, OAuth2 Client ID, and OAuth2 Client Secret in the connection request sent from Minga.

3. For SFTP connection, you will go through the self-serve rostering flow in the Minga app:

  • Enter your IT contact's name and email address in the provided field under People> Rostering.

  • Follow the prompts outlined in our step-by-step guide here: Setting up an SFTP connection with Minga Sync

    Supported File Formats and Required Files

    We recommend using industry-standard formats, such as OneRoster or Clever. You can check out the formatting by visiting the following guides:

    We recommend sharing the following:
    ​

    In Clever format, it's encouraged that they break out the files they send like this:

    • schools.csv

    • students.csv

    • teachers.csv

    • staff.csv

    • sections.csv

    • courses.csv

    • enrollments.csv

    In OneRoster 1.1 format, this is how files are broken out:

    • manifest.csv

    • academicSessions.csv

    • categories.csv

    • classResources.csv

    • classes.csv

    • courseResources.csv

    • courses.csv

    • demographics.csv

    • enrollments.csv

    • lineItems.csv

    • orgs.csv

    • results.csv

    • resources.csv

    • users.csv

For an in-depth guide on setting up automatic Rostering for your school, refer to these handy resources:

Bell Schedule Configuration

The Bell Schedule associates your SIS class data with specific times to provide real-time visibility into student movement.

For a step-by-step walkthrough on setting up your Bell Schedule, check out Set Up Your Bell Schedule in Minga.

To learn more about how Bell Schedule works and what information is needed, refer to Bell Schedules in Minga.

Data Reporting and Exports

To maintain a "source of truth" in your SIS, you can export activity data such as tardies and behavior incidents from Minga.

  • Open the module you wish to pull data from, such as Hall Pass or Behavior.

  • Navigate to the Reporting tab and select your desired Date Range.

  • Click Export List to generate a CSV file.

    • The data will automatically be mapped to student IDs for easy importing.

  • To automate this process, select Schedule Report to program recurring daily or weekly exports.

For a deeper dive into reports, check out these resources:

Troubleshooting

Issue: The nightly SIS sync failed to update student rosters.

Solution: If the nightly sync fails, first verify that your API credentials or SFTP login information have not expired or changed in your Student Information System. If credentials are correct, check the connection status in your Minga Sync settings. For further assistance, contact the support team at support@minga.io.

Issue: SFTP rostering issues due to incorrect file formatting

Solution: Ensure that the six mandatory CSV files are correctly formatted and include all required fields. Refer to the SFTP rostering requirements for guidance.

Issue: Minga domains are being blocked even after whitelisting.

Solution: If *.minga.io is whitelisted but access is still restricted, ensure that your firewall is not blocking traffic based on the specific App IDs for the Apple or Google stores. Confirm with your network team that the whitelist changes have propagated across all district access points.

FAQs

Is my school's data stored securely?

All school and student data resides in the United States and is hosted in partnership with Google. Minga meets federal and state standards for data collection and never shares personal information like names or email addresses

with third parties outside of your district.

What if my Student Information System (SIS) is not on the supported list?

If your SIS is not on the official supported list, it simply means Minga has not connected to it yet. Our support team will work with you to ensure a smooth integration regardless of your specific SIS provider.

Can I use other SIS platforms besides Aeries?

Yes, Minga supports various SIS platforms. Check the in-app guide for specific instructions for your SIS.

Can I automate my tardy reports? You can automate tardy reports by using the Scheduled Reports feature to schedule recurring exports. This allows you to receive daily, weekly, or monthly CSV files containing up-to-date student tardy data that you can then manually upload into your SIS.

Related Articles
Did this answer your question?