We log search terms to improve our documentation. For more information, read our Privacy Policy.
Manage a Node.js App
Last modified: 2026 October 15
Overview
After you deploy a Node.js™ app, you can manage it from the Websites hub. Click Manage next to the app’s website to open its detail view.
To manage a Node.js™ app, your account must have the Web Apps feature. When your account has this feature, the Websites hub appears as Websites & Apps.
Controlling your app’s process
To control the app’s running process, click Start, Stop, Restart, or Redeploy.
- Restart stops and starts the app’s process without rebuilding it. It doesn’t apply configuration changes, such as new environment variables. To apply them, click Redeploy.
- An app that serves static files only shows Redeploy.
Redeploy an app
Click Redeploy to rebuild the app and start it again with your current settings. Redeploy your app to:
- Deploy new code that you pushed to a Git™ repository.
- Recover an app that stopped or failed to deploy.
- Apply changes to the app’s startup command, environment variables, or database.
- Get the latest release of the app’s Node.js version. Your app then picks up security patches and other updates.
- If you force-push to your repository and rewrite its commit history, the redeploy fails. Meridian can only pull commits that add to the history it already has.
- Meridian doesn’t save the passphrase for a Secure Shell (SSH) key. If your repository uses a passphrase-protected key, enter the passphrase each time you redeploy.
Viewing and downloading logs
To view a snapshot of the app’s most recent log output, go to the App Logs tab.
- Click Download to save the log to your computer.
- Click Refresh to load newer entries.
When you deploy an app, Meridian saves the log output to the ~/.cpanel/logs/0123456789-deploy-<name>.log file, where ~ is your home directory, 0123456789 is a Unix epoch timestamp, and <name> is the name of your web app.
Managing environment variables
Go to the App Env tab to add, edit, or remove environment variables.
- Click Add Variable to add a new key and value.
- Click Reveal values to show hidden values.
- To add or update several variables at once, click Bulk Edit, then click Reveal to show the editor’s hidden contents before you paste. The new variables replace every environment variable in your app.
- Click Save & Restart to save your changes, or click Switch to normal mode to return to the row-by-row view.
- To rebuild your app and apply your configuration changes, redeploy the app.
- Each variable name must start with a letter or an underscore. It can contain only letters, numbers, and underscores.
- You can’t set the
PORTvariable. Meridian reserves it for the app’s process. - You can’t set variables in the App Env tab if Git tracks the app’s
.envfile.
Changing app settings
Go to the App configuration tab to review or change your app’s settings. You can:
- View the app’s Node.js version and package manager.
- Add a build or startup command.
- Change the app’s run mode.
- Manage the app’s database.
- Delete the app.
Changing an app’s run mode
Server apps can run in Production or Development mode. We recommend that you use Production mode. Development mode may restart your app’s process more often.
To change your app’s run mode, perform the following steps:
- Select the App configuration tab.
- Set either Production or Development for the Run mode toggle.
- Click Switch Mode to confirm. This restarts the app and briefly interrupts active connections. You can keep working while Meridian applies the change.
If you change your mind, click Cancel instead. Meridian leaves the app in its current mode.
If switching the run mode fails, Meridian reverts the toggle to your app’s prior mode and shows an alert explaining why. Resolve the issue that the alert describes, then try switching the mode again. If Meridian can’t restart the app automatically, click Redeploy to apply the new mode.
- The Run mode toggle only appears for apps that run a server process. The toggle does not appear for apps that serve static files.
- You cannot set the toggle if you haven’t yet deployed your app.
Managing your app’s database
You can connect a MySQL® database to your Node.js app to store data. Each app can have one database. To manage your app’s database, select the App configuration tab and find the Database section.
The Database section only appears if your hosting provider enables it for your account.
Add a database
To add a database to an existing app, click Add Database to create a new database. Or, click Link Database to link to an existing database. Then, click Redeploy to apply the changes.
To add a database to a new app, expand the Advanced section before deploying. Then, click Add Database. For more information, read our Deploying a Node.js app documentation.
- Meridian automatically names a new app’s database using the app’s name. If a database with the same name already exists, link your app to the existing database or delete it before deploying.
- Linking an existing database adds a new database user for the app. The database and its existing users don’t change.
- If you change the database user’s password in the Databases hub, remove the database from your app. Then, link it again to access the database with the new password.
Remove a database from your app
To stop your app from using a database, select one of the following options:
- Click Delete Database to permanently delete the database the app created. Then, type the database name and click Delete Database again to confirm.
Warning:
You cannot undo this action.
- Click Remove Database to stop using a linked database. Then, type the database name and click Remove from App to confirm. You can still access this database from the Databases hub.
Deleting a Node.js app
To delete an app, perform the following steps:
- Select the App configuration tab.
- Click Delete App.
- Optionally, select the Also delete the database checkbox to delete the app’s database. Deleting a database permanently removes the database and all of its data, but it does not delete the database’s users.
Note:
- This checkbox only appears if the app created the database.
- If you linked your app to an existing database, deleting the app only removes the app’s database user.
- If you don’t delete the database, you can access it later from the Databases hub.
- Enter the app’s name.
- Click Delete App again to confirm.
When you delete an app, Meridian stops its process and removes the app and its environment variables. Meridian does not remove any files that existed before you installed the app. If you don’t delete the database, you can access it later from the Databases hub.
- You cannot undo deleting an app or a database.
- If a domain only contains your app’s files, deleting the app also removes that domain from your account. For more information, read our Removing a domain documentation.