Try WSO2 Cloud for Free
Sign in

All docs This doc

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


titleClick to

To create a Ballerina service,

  • Go to WSO2 Integration Cloud, click CREATE APPLICATION, click  Ballerina , and then click the  Use Ballerina Composer  option. 
  • The Ballerina Composer is a visual tool that lets you code with diagrams. It starts with a hello service that you can modify as you like. Find out more about Ballerina at  
  • If you have created your Ballerina service locally, you can also deploy the  the Ballerina service archive (.bsz file) into the Integration Cloud, instead of using the Ballerina Composer directly on the Cloud.
  • Also try out these Ballerina by examples to dicover it more.


titleClick to

Here's how you create any type of application in the Integration Cloud:

  • Install Docker and create an account in Docker Hub.
  • Go to the folder of your sample application and execute the following command to create a Docker image in Docker Hub.

    Tip: The services running in the custom docker images in WSO2 Integration Cloud can only be exposed via ports 80 and 443. 

    The custom docker image routes traffic through one pair of ports from (9763,9443), (8080,8443), and (8280,8243). Traffic from port 80 goes through the first port in the pair while traffic from port 443 goes through the second. At the moment, you do not have support to use any pair of ports in the docker images 

    If you want to configure a port that is not listed above, please contact us via the Support link in WSO2 Integration Cloud.
    Code Block
    docker build -t <your_docker_hub_user_name>/<desired_docker_image_name>:<desired_tag> .
    For example: docker build -t maheshcwso2/node-js-hello:nonroot8080 .
    docker push

    Tip: Be sure to note the following when writing the Docker file:

    • Do not use the VOLUME command in the docker file (i.e., no host mounting).
    • Do not use the root user for the container.

      Code Block
      RUN useradd -ms /bin/bash nonRootUser
      USER nonRootUser
    • Avoid SSH services running inside the container.
  • The Docker image is now pushed to Docker Hub. Copy its URL.

  • Go to WSO2 Integration Cloud, Click CREATE APPLICATION, and then click the Custom Docker Images menu.
  • Upload the Docker image using the Docker Hub URL that you got earlier. 
  • After you have uploaded the image, you can create any number of applications using that custom Docker image.

Back to top ^