Skip to main content

Add Application

To help get you started and provide examples of minimal applications, you can use one of the Sevalla one-click templates from your Dashboard. To access these templates you must not have an existing application or static site and you must have a positive balance or credit card on your account.

Sevalla one-click templates.

Sevalla one-click templates.

Click on one of the template options and this automatically starts the application deployment.

Quick Start Templates are also available, so you can test Sevalla’s application hosting with a Hello World repository or follow the steps below to add your own application. 

To add an application, log in to Sevalla and click Applications > Add application. When you add an application, you can choose to link a Git repository or Docker image; the add application workflow differs depending on which option you choose. 

Add an application using a Git repository

Add a new application using a Git repository.

Add a new application using a Git repository.

  • Private repository: Choose GitHub, Bitbucket, or GitLab and connect your account. Once connected, you can choose a Git repository and Default branch.
    • Automatic deployment on commit allows you to automatically deploy your application each time a commit is made to the branch selected.
  • Public repository: Enter the Repository URL and choose a Branch.
  • Name: This name will be displayed in Sevalla for easy reference.
  • Location: Choose the data center you want to use for this application.
    warning

    Currently, internal connections are only supported between applications and databases in the same region. If you’d like to use a database with your application, you can create the database at Sevalla and use an internal connection between the two (on the application’s Settings page or the database’s Info page).

  • Resources: Choose the pod size for your process. This determines the CPU and RAM dedicated to the process.
  • Note: If you choose a Hobby pod size for your web process, you will not be able to add a custom domain to your application. If you need a custom domain for your application, you can upgrade this anytime.

Review your application’s monthly usage costs and confirm your payment method. If needed, add a new card for the payment method. Click Create & deploy to deploy the application immediately or Create to deploy the application manually at a later point.

Once you’ve created your application, you can add environment variables, background workers, cron jobs, or jobs within the Processes page, and persistent storage. if your application is stateless (no persistent storage), you can also enable automatic horizontal scaling for the web process within Processes. This lets you set a minimum and maximum number of instances (up to 10) that the process can scale between as needed.

Add an application using a Docker image

info

Sevalla only supports Docker images built for Linux/amd64 architecture. This is validated when you add an application and during the rollout phase.

Add a new application using a Docker image.

Add a new application using a Docker image.

  • Docker image: Enter the path to the Docker image. You can use public Docker images from any registry provider. You can access private Docker images from GitHub (ghcr.io), GitLab (registry.gitlab.com), or Docker Hub (docker.io) registries.
  • Registry credential (optional): This is only required for private Docker images. You must enter your registry credentials within username > Company settings > Registry credentials. Once you’ve entered your credentials in the Company settings, you can choose which credentials you want to use.
  • Name: This name will be displayed in Sevalla for easy reference.
  • Location: Choose the data center you want to use for this application.
    warning

    Currently, internal connections are only supported between applications and databases in the same region. If you’d like to use a database with your application, you can create the database at Sevalla and use an internal connection between the two (on the application’s Settings page or the database’s Info page).

  • Resources: Choose the pod size for your process. This determines the CPU and RAM dedicated to the process.
    • Note: If you choose a Hobby pod size for your web process, you will not be able to add a custom domain to your application. If you need a custom domain for your application, you can upgrade this anytime.

Review your application’s monthly usage costs and confirm your payment method. If needed, add a new card for the payment method. Click Create & deploy to deploy the application immediately or Create to deploy the application manually at a later point.

Once you’ve created your application, you can add environment variables, background workers, cron jobs, or jobs within the Processes page, and persistent storage. if your application is stateless (no persistent storage), you can also enable automatic horizontal scaling for the web process within Processes. This lets you set a minimum and maximum number of instances (up to 10) that the process can scale between as needed.

Visit app

Once your application is successfully deployed, you can open it using Visit App at the top of the Overview page within the application in Sevalla. The Overview page also shows you a diagram of your application so you can easily visualize its components and which ports it is listening on for incoming requests.  

Open your application from the Overview page with the Visit App button.

Open your application from the Overview page with the Visit App button.