Skip to main content
Modelence provides flexible configuration options for your application. You can configure your app through the startApp() function, environment variables, and Modelence Cloud settings.

​
Configuration Methods

There are three ways to configure your Modelence application, listed in order of precedence:
  1. Environment Variables - Highest priority, overrides everything
  2. Modelence Cloud - Synced configuration from cloud.modelence.com
  3. startApp() Options - Direct code configuration, lowest priority
Environment variables always take precedence, allowing you to override any configuration when deploying to different environments.

​
Basic Configuration with startApp()

The startApp() function is your application’s entry point where you configure core settings:
src/server/app.ts
import { startApp } from 'modelence/server';
import todoModule from './todo';
import userModule from './users';

startApp({
  // Register your modules
  modules: [todoModule, userModule],

  // Email configuration
  email: {
    provider: resendProvider,
    from: 'noreply@yourapp.com'
  }
});

​
Environment Variables

Environment variables provide a way to configure your application without hardcoding values. They override all other configuration methods.

​
Core Environment Variables

.modelence.env
# MongoDB connection string
MONGODB_URI="mongodb+srv://user:pass@cluster.mongodb.net/myapp"

# Server configuration
PORT=3000
MODELENCE_SITE_URL=http://localhost

## Modelence Cloud Configuration

When connected to Modelence Cloud, you can manage configuration through the cloud dashboard at [cloud.modelence.com](https://cloud.modelence.com):

1. Navigate to your application
2. Select your environment
3. Open the **Application** tab
4. Configure settings like:
   - Email providers
   - Environment variables
   - Database connections
   - Custom configuration

Changes made in the cloud dashboard are automatically synced to your application when it starts.

### Connecting to Modelence Cloud

```bash
npx modelence@latest setup --token <your_token>
This command creates a .modelence.env file with your cloud connection token.
See the Setup documentation for detailed instructions on connecting to Modelence Cloud.

​
Next Steps

Authentication

Configure authentication and user management

Email Setup

Set up email providers for transactional emails

Roles & Permissions

Define user roles and permissions

WebSockets

Enable real-time communication