Activating Modules

Premium modules (Núcleos, Check-in, Events, etc.) are included in every Neemias deployment. They are activated with a license key — no additional installation required.

Current mechanism (self-hosted deployments): modules are activated by an Ed25519-signed JWT set in the Worker LICENSE environment variable at deploy time — there is no in-app key activation yet. Operators: see Licensing (Operations) for key generation, minting, and deployment. The in-dashboard activation described below is the planned SaaS flow.

How it works

All modules are pre-installed in the bundle. A license key tells the system which modules your church is entitled to use.

One-click deploy → all modules in bundle → license key activates what you paid for

Getting a license key

1. Visit neemias.app and choose a plan
2. Complete the checkout (PIX, credit card, or boleto)
3. You will receive a license key via email
4. The key is a text string that looks like: NM-nucleus-XXXX-XXXX-XXXX

Activating a module

1. Log into your Neemias dashboard as an Administrator (ADMIN role)
2. Go to Settings → Licenses
3. Paste the license key into the field
4. Click Activate

The module is active immediately — no restart, no redeploy, no npm install.

After activation:

• New menu items appear in the sidebar (e.g., "Núcleos")
• New sections appear in Settings (e.g., "Núcleos" management)
• API routes are enabled for sync

Trial period

All modules come with a 30-day free trial. No credit card required. After 30 days, the module locks automatically until a license key is activated.

Renewing

Licenses are monthly (R$29/mês) or annual (R$249/ano = 2 months free).

Renewal is automatic — as long as the subscription is active, the key remains valid. If payment fails, a 30-day grace period begins. After that, the module locks.

What happens when a license expires?

• The module's pages show a "License expired" message instead of data
• API routes return 403 Forbidden
• Your data is preserved — it reappears when the license is reactivated
• Core functionality (attendance, students, classes, reports) is never affected

Offline mode

License keys are verified locally (no internet required after activation). The system uses Ed25519 cryptographic signatures — the key can be verified even when offline.

Troubleshooting

Problem	Solution
"Invalid license key"	Check for typos. Keys are case-sensitive.
"License expired"	Renew your subscription at neemias.app
Module doesn't appear after activation	Refresh the page (Ctrl+R / Cmd+R)
"Session expired" during activation	Log out and log back in

Support

• Email: suporte@neemias.app
• Documentation: neemias.app/docs