Environment Variables

Edit your application's environment variables directly from the control panel.

Accessing the Editor

1. Go to your Dashboard and select a deployment
2. Navigate to the "Technical" tab
3. Find the "Environment Variables" section

Viewing Variables

Variables are displayed in a list with their names. For security, values are hidden by default.

• Show value: Click the eye icon to reveal the value
• Hide value: Click again to hide it

Security

Sensitive variables like passwords and API keys are kept hidden to prevent accidental exposure.

Editing Variables

1. Click the "Edit" button in the upper right corner
2. Fields will become editable
3. Modify the values you need
4. When finished, choose an option:
   • Save only: Save changes without restarting the application
   • Save and restart: Save and restart the containers

Pending Changes

If you have unsaved changes, you'll see a yellow indicator "There are unsaved changes".

Adding a New Variable

1. Enable edit mode ("Edit" button)
2. Click "Add Variable"
3. Enter the variable name:
   • Only uppercase letters, numbers, and underscores
   • Example: MY_NEW_VARIABLE
4. Enter the value
5. Save the changes

Deleting a Variable

1. Enable edit mode
2. Click the trash icon next to the variable
3. Save the changes

Caution

Deleting variables that your application needs can cause it to stop working. Make sure you know which variables are required.

Canceling Changes

If you want to discard your unsaved changes:

1. Click "Cancel"
2. Values will return to their original state

When to Restart

Some variables require restarting the application to take effect:

Variable Type	Requires Restart?
Database URLs	Yes
External API Keys	Depends on the app
Ports	Yes
UI Configurations	Depends on the app

Recommendation

If you're not sure, use "Save and restart" to ensure the changes take effect.

Common Variables

All applications

• DOMAIN: Your subdomain (e.g., my-app.deployalo.com)

Database

• DB_PASSWORD: Database password
• DB_USER: Database user

Email (SMTP)

• SMTP_HOST: SMTP server
• SMTP_PORT: Port (465 for SSL, 587 for TLS)
• SMTP_USERNAME: SMTP user
• SMTP_PASSWORD: Password or API key

Administration

• ADMIN_EMAIL: Administrator email
• ADMIN_PASSWORD: Initial admin password

Troubleshooting

Changes are not applied

1. Make sure you saved (not just closed the panel)
2. Use "Save and restart" instead of "Save only"
3. Wait 30 seconds and check again

Application won't start after changing variables

1. Verify you haven't deleted required variables
2. Check the logs in Docker Logs to see the specific error
3. If necessary, restore a previous backup

I can't see certain variables

Some system variables are not shown in the editor. If you need to modify advanced configurations, use the Terminal.