The Configuration Section

The Configuration section enables you to perform configurations for your AppSail services from the console. These configurations can be done through the app-config.json file of your app for the Catalyst-managed runtime apps and then be deployed, or directly during deploying the app from the console for Catalyst-managed or custom runtimes. You could also configure the startup command in a container image depending on its setup for the apps deployed as a container image.

Note: All configurations you do in the app-config.json file, in the console, or in your container image will be reflected in this section in the console after you deploy your app. If you choose to edit the configurations from this section, that will override the configurations in your code or binaries.

appsail-startup-1

The steps to configure these values from the console are explained below.

Environmental Variables

You can create and store environmental variables as key-value pairs for your app outside of the main code, for both the development and production environments.

To create a new environmental variable:

  1. Click Create Variable in the Environmental Variables section.

appsail-env-1

  1. Enter the keyname and value of the variable. If you’re working from the development environment, the value you enter will be the development value, and vice-versa.

appsail-env-2

  1. Click Save.

The variable will be saved and listed in the section. You can search for variables by their keyname from the search bar, or add more variables.

appsail-env-3

If you’re working from the development environment, the development value is shown. If you switch to production environment, you can configure and view production values.

Note: You will be able to add Production variables only if your app has been deployed to production previously.

You can click the Usage Syntax button to check the syntax for each programming environment. This is explained in this section.

appsail-env-4

Edit an Environmental Variable

You can edit an environment variable’s development or production values from that environment in the following way:

  1. Click the ellipsis icon for the variable, then click Edit.

appsail-env-5

  1. Edit the values, then click Save.

appsail-env-6

Delete an Environmental Variable

You can delete the development or the production value of an environment variable from that environment. When you delete it from one environment, the value in the other environment is still available.

To delete an environmental variable:

  1. Click the ellipsis icon for the variable, then click Delete.

appsail-env-7

  1. Click Yes, Proceed to confirm.

appsail-env-8


Startup Command

You can configure the startup command for your app, or edit the command already present, from this section. Refer to the Startup Command section for details about this.

To configure or edit a startup command for your app:

  1. Click the Edit button in the Startup Command section.

appsail-startup-1

  1. Enter the startup command, then click Update.

appsail-startup-2


App Execution Settings

You can allocate the memory and disk size for your AppSail’s execution based on its performance requirements in this section. You can also configure the port for your app’s execution here. Refer to the links for details.

Note:
  • The memory can be configured in the app-config.json file for a Catalyst-managed runtime app while initializing or adding it from the CLI.
  • Catalyst assigns 256 MB for the disk size and 512 MB for the memory by default.
  • Configuring the port for a custom-runtime app is optional, as it can be configured while defining the container image as well. The values configured here will override these internal configurations.

To configure the memory, disk size, and port for an AppSail service:

  1. Navigate to the App Execution Settings tab, then click Edit.

appsail-mem-1

  1. Select the required memory and disk size for the app from the drop-down. Enter the port for the AppSail service. Click Save after configuring these details.

appsail-mem-2

Note: You can assign a port you need for your AppSail service. Ports within the range of 0 to 1024 are reserved, with the exception of ports 80 and 443. You can use any port other than these. Port 9000 will be used by default. If you have not configured the port in your code, ensure that you configure the same port to listen to while starting the server in the startup command of your app.

Last Updated 2025-11-03 20:12:13 +0530 IST