Render Integration
Render is a modern cloud platform for deploying web applications, APIs, and static sites. The EnvManager Render integration automatically syncs your environment variables to Render services and environment groups, eliminating manual copying and ensuring your deployments always have the latest configuration.
What You Can Do
- Connect with API Key - Securely link your Render account
- Sync to Services - Push variables directly to specific Render services
- Sync to Environment Groups - Share variables across multiple services
- Create Environment Groups - Create new groups directly from EnvManager
- Auto-sync on Changes - Keep Render automatically updated when you modify variables
- View Sync History - Track every sync with full audit trail
Before You Begin
You'll need:
- An EnvManager project with environment variables
- A Render account (free or paid)
- Permission to create API keys in Render
Getting Your Render API Key
Log in to Render
Go to dashboard.render.com and sign in.
Open Account Settings
Click your profile icon in the top right, then select Account Settings.
Navigate to API Keys
In the left sidebar, click API Keys.
Create a New API Key
- Click Create API Key
- Give it a descriptive name like "EnvManager Integration"
- Click Create
- Copy the key immediately - you won't be able to see it again
Keep Your API Key Safe: Treat this key like a password. It grants full access to your Render account. Store it securely and never share it publicly.
Connecting Your Render Account
Open Your Project
Navigate to the project in EnvManager where you want to set up the Render integration.
Go to Integrations Tab
Click the Integrations tab in the project navigation.
Connect Render
Click the Connect button on the Render integration card.
Enter Your API Key
A modal will appear asking for:
| Field | Description |
|---|---|
| Connection Name | A friendly name to identify this connection (e.g., "My Render Account") |
| API Key | The API key you created in Render |
Validate the Key
Click Validate Key. EnvManager will verify the key works and fetch your Render workspaces.
Select Workspace (if you have multiple)
If your API key has access to multiple workspaces (personal account plus teams), you'll see a dropdown to select which workspace to use.
Click Connect
Click Connect to save the connection. Your Render account is now linked.
Multiple Workspaces: If you need to sync to services in different Render workspaces, create separate connections for each workspace.
Configuring Your Sync
After connecting, you need to configure which Render target to sync to and which EnvManager environments to include.
Click Configure
In the integrations list, click Configure on your Render connection.
Choose Target Type
Select whether to sync to a Service or an Environment Group:
| Target Type | When to Use |
|---|---|
| Service | Sync variables to a single specific service (web service, background worker, etc.) |
| Environment Group | Share variables across multiple services (recommended for shared configs like database URLs) |
Select or Create Target
For Services:
- Choose an existing service from the dropdown
- The list shows all services in your Render workspace
For Environment Groups:
- Select Create New to create a new environment group, then enter a name (e.g., "production-secrets")
- Or select Use Existing to sync to an existing environment group
Map Environments
Select which EnvManager environments should sync to Render:
- Check the box next to each environment you want to include
- For example, you might sync only your "Production" environment to a production service
- Or sync "Development" and "Staging" to a preview environment group
Configure Sync Options
Set your sync preferences:
| Option | Description |
|---|---|
| Auto-sync | Automatically trigger sync whenever you add, edit, or delete variables in mapped environments |
| Sync secrets | Include variables marked as secrets (they'll be visible in Render) |
| Sync regular variables | Include non-secret variables |
Save Configuration
Click Save Configuration. If you created a new environment group, EnvManager will automatically perform the first sync to populate it.
Tip: Environment groups are ideal for shared configuration like database URLs, API endpoints, and third-party service credentials that multiple services need.
How Syncing Works
EnvManager uses a non-destructive merge strategy:
- Fetch existing variables from Render
- Merge with variables from your mapped EnvManager environments
- Push the combined set back to Render
This means:
- Variables that exist only in Render are preserved
- Variables that exist in both are updated with EnvManager values
- New variables from EnvManager are added
- Deleted variables in EnvManager are removed from Render
Important: EnvManager is the source of truth. If you manually change a synced variable in Render, it will be overwritten on the next sync.
Manual Sync
You can trigger a sync manually at any time:
Open Integrations Tab
Navigate to your project's Integrations tab.
Find Your Render Connection
Locate the configured Render connection in the list.
Click Sync Now
Click the Sync Now button. A sync will run immediately.
Check Sync Status
The sync status will update to show "Syncing..." then "Last synced: just now" when complete.
Manual sync is useful for:
- Testing your integration after setup
- Forcing a sync after making multiple changes with auto-sync disabled
- Troubleshooting sync issues
Auto-Sync
When auto-sync is enabled, EnvManager automatically syncs whenever you:
- Add a new variable in a mapped environment
- Edit a variable value in a mapped environment
- Delete a variable from a mapped environment
- Change a variable's secret status
Auto-sync happens in the background and typically completes within seconds.
Viewing Sync History
Every sync is logged with full details:
Open Integrations Tab
Go to your project's Integrations tab.
View History
Find your Render connection and click View History or expand the connection card to see recent syncs.
Review Sync Details
For each sync, you'll see:
- Timestamp - When the sync occurred
- Triggered By - Who initiated the sync (user action or auto-sync)
- Status - Success or error
- Variables Synced - Count of variables pushed
- Environments - Which environments were included
Sync history helps you:
- Verify syncs completed successfully
- Troubleshoot issues
- Audit when configuration changes were deployed
Managing Your Connection
Editing Connection Settings
To change which environments sync or toggle auto-sync:
- Click Configure on the Render connection
- Update your settings
- Click Save Configuration
Disconnecting
To remove the Render integration:
- Click the Disconnect button on the connection card
- Confirm the disconnection
- The connection and sync configuration will be removed
Disconnecting from EnvManager does not delete variables in Render. Your services will continue running with the last synced values.
Tips & Best Practices
Environment Group Strategy
- Create one group per environment stage (e.g., "production-config", "staging-config")
- Use groups for shared configuration like databases, caches, and third-party APIs
- Keep service-specific variables in the service itself rather than the group
Selective Syncing
- Don't sync everything - Only include environments that deploy to Render
- Use multiple connections if you have separate Render accounts for different environments
- Disable auto-sync if you prefer to control exactly when deployments get new config
Secret Handling
- Remember secrets are visible in Render - Render does not have a separate secret type
- Use Render's environment-specific values if you need different secrets per Render environment
- Keep truly sensitive secrets in Render's Secret Files feature for files like private keys
Testing Changes
- Use a staging environment first - Test variable changes in staging before syncing to production
- Check sync history - Verify syncs completed before testing your application
- Monitor deployments - Some variable changes may require a service restart in Render
Troubleshooting
"Invalid API Key" Error
Solution: Your API key may have been revoked or expired. Generate a new API key in Render and update your connection.
"Service Not Found" Error
Solution: The service may have been deleted in Render. Reconfigure the sync target to point to a different service or environment group.
Variables Not Updating in Render
- Check sync history to confirm syncs are completing successfully
- Verify the environment is mapped in your sync configuration
- Ensure auto-sync is enabled if you expect automatic updates
- Try a manual sync to force an update
Auto-sync Not Triggering
- Verify auto-sync is enabled in your sync configuration
- Check that you're editing variables in a mapped environment
- Review sync history for error messages
New Environment Group Not Appearing
If you created a new environment group but it's not showing in Render:
- Wait a few seconds and refresh your Render dashboard
- Check that the initial sync completed successfully in sync history
- Verify you're looking at the correct Render workspace
Related Topics
Managing Variables
Learn how to create and organize variables in EnvManager.
Environments
Understand how environments work in EnvManager.
Working with Secrets
Best practices for handling sensitive configuration.