# AppSail in the Console -------------------------------------------------------------------------------- title: "Overview" description: "Catalyst AppSail is a fully-managed platform of Catalyst Serverless that enables you to develop and deploy web services in managed runtimes of Java, Node.js, and Python, or of custom runtimes as OCI images to the cloud with ease." last_updated: "2026-03-18T07:41:08.634Z" source: "https://docs.catalyst.zoho.com/en/serverless/help/appsail/console/overview/" service: "Serverless" -------------------------------------------------------------------------------- # AppSail in the Console ## The Overview Section The *Overview* tab contains the general details of the app service, the {{%link href="/en/serverless/help/appsail/key-concepts/appsail-execution/#custom-domain-url" %}}deployment URL{{%/link%}}, and a live dashboard of the instances that are actively running. <br /> These include the details of the {{%link href="/en/getting-started/set-up-a-catalyst-project/collaborators/" %}}admin or collaborator{{%/link%}} that deployed the app, the date and time of the app's creation and last deployment, and a **unique AppSail ID** created for your app automatically after you deploy it. This will also specify if the app is a Catalyst-managed runtime or a custom runtime, and if the source is the CLI, console, or a container registry service. You can find the Image Path or URL of the image from its container registry service, in the last case. ### AppSail URL After your AppSail service is deployed, Catalyst hosts your app on a sub-domain with which you can access it. You can access the various endpoints that you configure in your app from this base URL. The default base URL of your AppSail service will be of this format for development environment: {{% code class="language-json" %}}https://appsailservicename-ZAID.development.catalystappsail.com{{%/code%}} For example: {{% code class="language-json" %}}https://demoservice-1011034735.development.catalystappsail.com{{%/code%}} This will be the format for the production environment: {{% code class="language-json" %}}https://appsailservicename-ZAID.catalystappsail.com{{%/code%}} * **AppSail service name:** The name you provide while initializing or deploying the app * **ZAID:** The unique identifier that maps an application to a project {{%note%}}{{%bold%}}Note:{{%/bold%}} The "development" indicates the development environment of your project. After you {{%link href="/en/deployment-and-billing/environments/introduction/" %}}deploy your project to production{{%/link %}}, the URL will not include that key.{{%/note%}} #### Custom AppSail URL Catalyst provides you with the convenience of editing the AppSail service name and ZAID part of the URL, and adding any sub-domain name of your choice for the AppSail URL. The "catalystappsail" domain will remain the same in this method, along with the "development" key for the apps in the development environment. 1. You can edit the AppSail URL by clicking the **Edit AppSail URL** from the Overview section. <br /> 2. Enter the sub-domain name that you require, then click **Update**. <br /> <br> ### Live dashboard The dashboard displays every currently running instance of the app after it is invoked. <br /> AppSail spawns a new instance for your app after a running instance is almost entirely consumed. You will be able to see the percentage of consumption of each instance, and details such as the unique {{%bold%}}Instance ID{{%/bold%}} and the duration it has been running for. You can click {{%bold%}}Refresh{{%/bold%}} to get an updated status of the active instances, in case there are lags. <br /> ### Delete an Active Instance You can manually delete an active instance if you require, in cases when you experience a bug or a deadlock situation, such as an infinite loop bug. 1. Click the ellipsis icon for an instance, then click **Delete**. <br> 2. Click **Yes, Proceed** in the confirmation pop-up. <br> -------------------------------------------------------------------------------- title: "Instances" description: "Catalyst AppSail is a fully-managed platform of Catalyst Serverless that enables you to develop and deploy web services in managed runtimes of Java, Node.js, and Python, or of custom runtimes as OCI images to the cloud with ease." last_updated: "2026-03-18T07:41:08.635Z" source: "https://docs.catalyst.zoho.com/en/serverless/help/appsail/console/instances/" service: "Serverless" -------------------------------------------------------------------------------- # The Instances Section The Instances section provides valuable insights about the instances that were executed in the form of simple graphs, the execution history details, as well as execution logs. ### Analytics <br /> In the **Analytics** section, you can select a duration for the stats you would like to see using the duration drop-down. The graphs will be refreshed to depict stats accordingly. <br /> The graphs in this section include: * **Max Instances and No. of Requests vs Time:** Depicts the maximum number of instances that were spawned in parallel and the number of requests that were served with these instances through the line graph at specific points of time. Based on the duration you select, the time intervals will vary in the graph. * **Total Instances and Run Duration vs Time:** Depicts the total number of instances that were active and the total duration of the execution of all instances through the line graph at specific points of time. Based on the duration you select, the time intervals will vary in the graph. You can hover over any part of the graphs to see details. ### History Click the **History** tab to view the execution history of your app. <br /> You can select a duration for the logs you would like to see through the duration drop-down on the right hand side. The execution logs will be refreshed accordingly. <br /> The details shown here include the total number of instances run, then the Instance ID, start date and time, end date and time, and the duration of each instance execution. You can also filter the results by clicking the **Filter** button. Click **Search by ID** to filter by Instance ID. You can also select the Duration box, then select a comparison type and pick hours and minutes from the drop-downs to find matches accordingly. <br /> Click **Apply** after you configure the filters to view results. Additionally, you can access the **execution logs** of each instance by clicking the respective logs icon. This will redirect you to {{%link href="/en/devops/help/logs/introduction/" %}}Catalyst Logs{{%/link%}} in the DevOps service. The filters for the logs come automatically applied. <br /> -------------------------------------------------------------------------------- title: "Deployments" description: "Catalyst AppSail is a fully-managed platform of Catalyst Serverless that enables you to develop and deploy web services in managed runtimes of Java, Node.js, and Python, or of custom runtimes as OCI images to the cloud with ease." last_updated: "2026-03-18T07:41:08.636Z" source: "https://docs.catalyst.zoho.com/en/serverless/help/appsail/console/deployments/" service: "Serverless" -------------------------------------------------------------------------------- # Deployments The Deployments section displays all the deployments of the specific AppSail service, along with its deployment details, and links to the deployment logs as applicable. <br /> You can view details such as the source of a particular deployment, the {{%link href="/en/getting-started/set-up-a-catalyst-project/collaborators/" %}}admin or collaborator{{%/link%}} that deployed it, the date and time of deployment, and the status. {{%note%}}{{%bold%}}Note:{{%/bold%}} When you create a new deployment for an existing AppSail service, you can deploy the app from the CLI, the console, or from a container-registry service, essentially changing the type of app as a Catalyst-managed runtime or a custom runtime as you prefer. An individual AppSail service is not tied to one of these types, as the type and source can be different for each of its deployments. {{%/note%}} Because each deployment is different, the Deployments section will mention if a particular deployment is a Catalyst-managed runtime or a custom runtime, and if the source is the CLI, console, or a container registry service. You can find the Image Path or URL of the image from its container registry service, in the last case. ### Deployment Logs The Deployment logs are available only for container images deployed directly from the container registry service. To view the log of a particular deployment, click the logs icon shown for it. <br /> #### Create a New Deployment You can create a new deployment for an existing AppSail service from the Deployments section, by clicking the **Create Deployment** button on the top-right corner. This will initiate the process of deploying the app from the console for {{%link href="/en/serverless/help/appsail/key-concepts/appsail-execution/#custom-domain-url"%}}Catalyst-managed runtime{{%/link%}} or a {{%link href="/en/serverless/help/appsail/key-concepts/appsail-execution/#custom-domain-url"%}}custom runtime{{%/link%}}, and the steps will be the same. As mentioned earlier, you have the flexibility to change the source and the type of app (Catalyst-managed runtime or custom runtime) from its previous deployments by clicking **Edit** for the source. -------------------------------------------------------------------------------- title: "Configurations" description: "Catalyst AppSail is a fully-managed platform of Catalyst Serverless that enables you to develop and deploy web services in managed runtimes of Java, Node.js, and Python, or of custom runtimes as OCI images to the cloud with ease." last_updated: "2026-03-18T07:41:08.636Z" source: "https://docs.catalyst.zoho.com/en/serverless/help/appsail/console/configurations/" service: "Serverless" -------------------------------------------------------------------------------- # 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 {{%badge%}}{{%link href="/en/serverless/help/appsail/key-concepts/catalyst-configurations/#the-app-configjson-file"%}}app-config.json{{%/link%}}{{%/badge%}} file of your app for the {{%link href="/en/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/"%}}Catalyst-managed runtime{{%/link%}} apps and then be deployed, or directly during deploying the app from the console for Catalyst-managed or {{%link href="/en/serverless/help/appsail/custom-runtimes/container-registry-services/"%}}custom runtimes{{%/link%}}. You could also configure the startup command in a container image depending on its setup for the apps deployed as a container image. {{%note%}}{{%bold%}}Note:{{%/bold%}} All configurations you do in the {{%badge%}}app-config.json{{%/badge%}} 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.{{%/note%}} <br /> The steps to configure these values from the console are explained below. ### Environmental Variables You can create and store {{%link href="/en/serverless/help/appsail/key-concepts/appsail-execution/#environmental-variables"%}}environmental variables{{%/link%}} as key-value pairs for your app outside of the main code, for both the {{%link href="/en/deployment-and-billing/environments/introduction/"%}}development and production environments{{%/link%}}. To create a new environmental variable: 1. Click **Create Variable** in the *Environmental Variables* section. <br /> 2. 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. <br /> 3. 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. <br /> 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%}}{{%bold%}}Note:{{%/bold%}} You will be able to add Production variables only if your app has been deployed to production previously.{{%/note%}} <br> You can click the **Usage Syntax** button to check the syntax for each programming environment. This is explained in {{%link href="/en/serverless/help/appsail/key-concepts/appsail-execution/#use-an-environmental-variable"%}}this section{{%/link%}}. <br /> #### 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**. <br /> 3. Edit the values, then click **Save**. <br /> #### 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**. <br /> 3. Click **Yes, Proceed** to confirm. <br /> <br> ### Startup Command You can configure the startup command for your app, or edit the command already present, from this section. Refer to the {{%link href="/en/serverless/help/appsail/appsail-configurations/#startup-commands"%}}Startup Command section{{%/link%}} for details about this. To configure or edit a startup command for your app: 1. Click the **Edit** button in the *Startup Command* section. <br /> 2. Enter the startup command, then click **Update**. <br /> <br> ### App Execution Settings You can allocate the {{%link href="/en/serverless/help/appsail/appsail-configurations/#memory-and-disk-allocation"%}}memory and disk size{{%/link%}} for your AppSail's execution based on its performance requirements in this section. You can also configure the {{%link href="3/en/serverless/help/appsail/appsail-configurations/#ports-for-app-executions"%}}port{{%/link%}} for your app's execution here. Refer to the links for details. {{%note%}}{{%bold%}}Note:{{%/bold%}} <br> * The memory can be configured in the {{%link href="/en/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/#the-app-configjson-file"%}}{{%badge%}}app-config.json{{%/badge%}}{{%/link%}} 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.{{%/note%}} To configure the memory, disk size, and port for an AppSail service: 1. Navigate to the **App Execution Settings** tab, then click **Edit**. <br /> 2. 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. <br /> {{%note%}}{{%bold%}}Note:{{%/bold%}} 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.{{%/note%}} -------------------------------------------------------------------------------- title: "Manage AppSail" description: "Catalyst AppSail is a fully-managed platform of Catalyst Serverless that enables you to develop and deploy web services in managed runtimes of Java, Node.js, and Python, or of custom runtimes as OCI images to the cloud with ease." last_updated: "2026-03-18T07:41:08.638Z" source: "https://docs.catalyst.zoho.com/en/serverless/help/appsail/console/manage-appsail/" service: "Serverless" -------------------------------------------------------------------------------- # Manage AppSail ### Disable an App You can temporarily disable an AppSail service, if required. When an app is disabled, it cannot be invoked through its development or production {{%link href="/en/serverless/help/appsail/key-concepts/appsail-execution/#custom-domain-url"%}}deployment URL{{%/link%}} until you enable it again. {{%note%}}{{%bold%}}Note:{{%/bold%}} You can still create or modify configurations for the app, or deploy changes from your local environment even when the app is disabled.{{%/note%}} To disable an app in AppSail: 1. Click the ellipsis icon for an app from the AppSail index page, then click **Disable**. <br /> 2. Enter "DISABLE" in the pop-up to confirm, then click **Confirm**. <br /> This will change the status of the app to "Inactive" in the index page. <br> #### Enable the App You can enable a disabled app again by navigating to the index page. 1. Click the ellipsis icon, and then click **Enable**. <br /> 2. Click **Yes, Proceed** to confirm. <br /> <br> ### Delete an App You can permanently delete an AppSail app from the remote console. This will remove the app from being hosted in AppSail. To delete an app in AppSail: 1. Navigate to the AppSail's index page. Then, click the ellipsis icon for the app, and click **Delete**. <br /> 2. Enter "DELETE" in the pop-up to confirm, then click **Confirm**. <br /> You will need to deploy the app again after it is deleted, if you require it. <br> ### Download an App's Code Catalyst enables you to download the source code of a deployed AppSail service from the console to your local system for **Catalyst-managed runtime apps only**. This will download a ZIP file of the entire directory that was deployed to the console, which includes the application files and any configuration files that were bundled and uploaded. This is not available for a custom runtime app. You can download an AppSail app's source code by clicking the ellipsis icon of an app from the AppSail index page, then clicking **Download**. <br />