Deploy AppSail as a Custom Runtimr from the Console

AppSail enables you to deploy an app as a container image from the Catalyst console directly. The steps given here are common for all the Container Registry services.

Navigate to the Serverless service in your Catalyst project that you wish to deploy your app in, then click AppSail under Compute.

Upon clicking Deploy from CLI, a pop-up will show you the instructions to deploy an AppSail service from the CLI. Refer the CLI help section for detailed steps.

Click Deploy from Console to directly deploy your app here.
Select the deployment type as Docker Image, and provide a name for your AppSail service. Select the deployment type as Docker Image, and select the Container Registry Service from the list: Docker Hub, AWS ECR, or Google Artifact Registry.

Enter the following according to the service you choose-

Docker Hub- Image URL
Amazon ECR- Image URI
GCP Artifact Registry- Image Path

Refer to the help links on details to fetch them.

You must select the credentials of the Container Registry Service that you will use for your OCI image deployment. The drop-down will list all the credentials that you have configured with the container service.

You can select an existing credential or click the Create Integration button below to add a new credential. This will redirect you to Integration Settings .

Note: The steps to add and manage Catalyst integrations for Docker Hub, AWS, or Google Cloud Platform are covered in their respective help sections.

You can configure advanced settings for your app.

i. Provide a startup command for your app based on your app’s runtime.

Note: If you have already d the startup command in your container image, the command you provide in Catalyst will take priority.

ii. Configure a custom port for your app’s execution, if needed. Ports within the range of 0 to 1024 are reserved, with the exception of ports 80 and 443. You can use any other ports outside this range. Port 9000 will be used by default.

Note: 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.

iii. Configure the required memory for your app’s execution, based on your requirements. You can select 128, 256, 512, 1024, or 2048 MB.

Info: You can also configure the disk size for your app's execution after you deploy the app from the Configuration section.

iv. Configure environment variables for your AppSail service as needed.

You can add multiple environment variables by clicking the + icon, and remove them by clicking the — icon.

Info: The environment variable will be added to the Catalyst environment (development or production) that you're currently working in. You can change the environment from the drop-down at the top of the console, and add variables as required.

After you configure the details, click Deploy.

Your app will be deployed to the console. You will now be able to view and manage your app from the console.

Refer here for help on managing your AppSail service.

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

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit