Deploy & admin
Environment variables
Required and optional environment configuration for app, auth, mail, payments, and cron.
Deploy & admin guide for day and boarding schools.
Last updated July 24, 2026
Schoolyi reads configuration from tracked .env templates and server-specific .env.prod. Never commit secrets to public repositories - use server-side merge during deploy.
| Variable | Required | Purpose |
|---|---|---|
| DATABASE_URL | Yes | MySQL connection string |
| NEXTAUTH_URL | Yes | Canonical app URL for auth callbacks |
| NEXTAUTH_SECRET | Yes | Session encryption - rotate with care |
| NEXT_PUBLIC_SITE_URL / APP_URL | Yes | Public links in emails, PDFs, and deep links |
| SMTP_* | For email | Fee receipts, admissions, magic link, boarding alerts |
| FEES_ONLINE_PAYMENT_MODE | Recommended | simulate (default) or razorpay - Razorpay keys only if razorpay |
| RAZORPAY_* | Optional | Only when FEES_ONLINE_PAYMENT_MODE=razorpay |
| FEES_CRON_SECRET / SESSION_COOKIE | For cron | scripts/run-school-cron.sh auth |
| NEXT_PUBLIC_DEPLOY_ENV | Recommended | Shows non-prod badge in UI |
| DEPLOY_* | For SSH deploy | Host, user, keys in .env |
Common questions
Quick answers in plain language.
What is school ERP implementation?+
Required and optional environment configuration for app, auth, mail, payments, and cron. This is a core topic in Deploy & admin on Schoolyi.
How do I set up environment variables in school management software?+
Follow the steps in this guide during environments, migrations, and operations runbooks. Start with getting-started docs if you are new to Schoolyi, then apply the workflows here for your school year.
How does Schoolyi handle environment variables?+
Required and optional environment configuration for app, auth, mail, payments, and cron.
Is there a school ERP implementation guide for school administrators?+
Yes. This article is part of the public Deploy & admin documentation at /docs - written for administrators, operators, and IT teams.
Who manages environment variables at a typical K-12 school?+
Usually deploy & admin and front-office staff responsible for school ERP implementation. Teachers and finance may have scoped access depending on your role configuration.
Does Schoolyi support school software deployment?+
Yes. Schoolyi is a cloud school management system (SMS) with connected modules on one student roster and academic calendar. See related guides below or contact us for a demo focused on school ERP implementation.
Related searches
School leaders and IT teams often search for: how to environment variables in school management software, best school ERP implementation for K-12 schools, Schoolyi environment variables guide, school software deployment, MySQL school database backup, and school SaaS hosting.