> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sevalla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Applications - Settings

> Change your application's settings and preferences.

On your application's **Settings** page, you can find details about your application, manage settings like buildpacks, and suspend or delete it.

## General

<Frame caption="General settings for your application.">
  <img className="block dark:hidden" alt="General settings for your application" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-general-light.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=1a274c128bbcf5f3315730d388ed11f2" width="2552" height="788" data-path="images/settings-general-light.png" />

  <img className="hidden dark:block" alt="General settings for your application" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-general-dark.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=9fab48c1aeae12fc8b18b213238acdaf" width="2560" height="800" data-path="images/settings-general-dark.png" />
</Frame>

### Details

This section shows the application display name, name, and ID. To change the display name, click **Update display name**, enter a new name, and click **Update display name**.

### Hibernation

Hibernation automatically scales down your application if no HTTP requests are received within the specified timeframe. When traffic resumes, the application wakes up in 8-20 seconds, with the HTTP request remaining pending during that time. Cron jobs and other jobs continue to run normally, even while hibernation is active. To enable hibernation on your application, click **Update hibernation**.

Select **Hibernation**, enter the number of idle minutes after which you want your application to enter hibernation, and click **Update hibernation**.

<Frame caption="Hiberation settings for your application.">
  <img className="block dark:hidden" alt="Hiberation settings" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-hibernation-light.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=9a645c310862fec44f589bb23abba163" width="1190" height="752" data-path="images/update-hibernation-light.png" />

  <img className="hidden dark:block" alt="Hiberation settings" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-hibernation-dark.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=5396f19330bc2b92b3eed586fed04924" width="1182" height="784" data-path="images/update-hibernation-dark.png" />
</Frame>

## Deploy

<Frame caption="Deploy settings for your application.">
  <img className="block dark:hidden" alt="Deploy settings for your application" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-deploy-light.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=9dc1f5053225df0b18da9005f5ce501d" width="2558" height="1340" data-path="images/settings-deploy-light.png" />

  <img className="hidden dark:block" alt="Deploy settings for your application" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-deploy-dark.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=7a75c22c0ec5568726550d5e2bcb80dc" width="2562" height="1350" data-path="images/settings-deploy-dark.png" />
</Frame>

### Source

This shows the information about the application source. The information shown depends on whether you use a Git repository or a Docker image.

#### Git repository

* **Source type:** Shows if the repository is private or public.
* **Git type:** Shows which Git provider the application is using.
* **Repository:** The Git repository.

#### Docker image

* **Source type:** This shows that the application is using a Docker image.
* **Docker image:** This is the path to your Docker image.
* **Registry credential:** This shows the name of the registry credentials set up within **Integration** > **Registry credentials**.

To change any of the details, click **Update source**.

### Auto-deploy

Use this option to automatically deploy each time a commit is made to the selected branch.

To enable or disable automatic deployments or change the branch to automatically deploy from, click **Update auto-deploy**. Select the required options and click **Update auto-deploy**.

<Frame caption="Auto-deploy settings for your application.">
  <img className="block dark:hidden" alt="Auto-deploy settings for your application" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-auto-deploy-light.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=db206886cf908250fb12f2fe81f6bf34" width="1180" height="750" data-path="images/update-auto-deploy-light.png" />

  <img className="hidden dark:block" alt="Auto-deploy settings for your application" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-auto-deploy-dark.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=2f0e0e0c1a18838c4041dfb908d799ae" width="1184" height="892" data-path="images/update-auto-deploy-dark.png" />
</Frame>

### Deploy hook

Deploy hooks allow you to effortlessly trigger deployments by making a simple POST request to a unique URL, enabling seamless workflow integration.

To set up a deploy hook, click **Enable** and then click **Continue**. This generates a unique URL that you can call with a POST request to trigger a deployment. If you want to automate deployments based on external events (e.g., pushing code to a repository), you can configure a webhook in your repository provider (GitHub, GitLab, Bitbucket, or Docker) to call the deploy hook URL.

<Frame caption="Set up a deploy hook for your application.">
  <img className="block dark:hidden" alt="Set up a deploy hook for your application" src="https://mintcdn.com/sevalla/Jux_WOUQ8HU0TATP/images/deploy-hook-light.png?fit=max&auto=format&n=Jux_WOUQ8HU0TATP&q=85&s=4dd4414b2eb80ae135f3f235b9163887" width="2550" height="326" data-path="images/deploy-hook-light.png" />

  <img className="hidden dark:block" alt="Set up a deploy hook for your application" src="https://mintcdn.com/sevalla/Jux_WOUQ8HU0TATP/images/deploy-hook-dark.png?fit=max&auto=format&n=Jux_WOUQ8HU0TATP&q=85&s=4fdb00c68bde49745f16b1706e2d491e" width="2554" height="338" data-path="images/deploy-hook-dark.png" />
</Frame>

### Deploy paths

Deploy paths allow you to trigger deployments based on a specific set of rules. You can define which file changes should initiate a deployment and which should be ignored. For example, you can trigger deployments only when files in `/src/backend/**` are modified or skip deployments if changes are limited to `**/*.md` files. This can be especially useful for monorepos.

<Warning>
  This feature is only available for applications with a private GitHub or GitLab repository. It is not available for Bitbucket repositories or Docker images.
</Warning>

To configure deploy paths, click **Update deploy paths**.

To trigger a deployment when a file is changed within a specific path, select **Allow paths**. To skip a deployment when a file is changed in a specific path, select **Ignore paths**. Add the required path patterns and click **Update deploy paths**.

<Frame caption="Add the required deploy paths to trigger or skip a deployment.">
  <img className="block dark:hidden" alt="Update deploy paths" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-deploy-paths-light.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=670b0b2f19ff8b632c18772548c3f486" width="1580" height="878" data-path="images/update-deploy-paths-light.png" />

  <img className="hidden dark:block" alt="Update deploy paths" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-deploy-paths-dark.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=04b1207a969001b247319abac46a5702" width="1588" height="906" data-path="images/update-deploy-paths-dark.png" />
</Frame>

### Git Large File Storage (LFS)

If your repository tracks files with [Git LFS](https://git-lfs.com/), Git LFS support ensures the actual file contents are fetched when the repository is cloned for a build. When disabled, LFS pointers are checked out as-is and the underlying objects are not downloaded.

Git LFS is enabled by default. The current state is shown as a **Git LFS enabled** or **Git LFS disabled** badge. To change it, click **Enable** (or **Disable** if it is already on), then click **Continue**. The change takes effect on the next deployment.

<Info>
  Git LFS is only available for applications deployed from a Git repository, not from a Docker image.
</Info>

## Build

<Frame caption="Build settings for your application.">
  <img className="block dark:hidden" alt="Build settings for your application" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-build-light.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=94acf6438246c46c08b071181caf4ea2" width="2560" height="618" data-path="images/settings-build-light.png" />

  <img className="hidden dark:block" alt="Build settings for your application" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-build-dark.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=26a3350a130772fd6b8235afccb244c7" width="2560" height="622" data-path="images/settings-build-dark.png" />
</Frame>

### Build strategy

This shows information about your environment's build strategy. To change any of these settings, click **Update build strategy**, and select from the following:

#### Nixpacks

Use [Nixpacks](/applications/build-options/nixpacks) to create a container for your application based on your repository.

* **Cache enabled:** When you build your application, Sevalla creates a deployable image from your code. By default, cache is enabled, which stores the latest successful deployment so that future builds can reuse unchanged components, significantly speeding up the process and reducing resource usage.
* **Build path:** This is the path in the repository to the files required to build the application. Most applications are built from the repository root, and the **Build path** defaults to this (.). If you have a different build path, specify it here. For example, if your application needs to be built from a subdirectory named **app**, enter **app** in the **Build path** field. This is also useful if you have a [monorepo](/applications/reference/glossary#monorepo).
* **Nixpacks version:** Choose the Nixpacks version you want to use to build your application. Different versions can affect the build process, so it’s important to review the [<u>Nixpacks changelog</u>](https://github.com/railwayapp/nixpacks/releases) for your application’s language. Ensuring compatibility is your responsibility, as changes between versions may impact how your application is built and runs.

<Frame caption="Select Nixpacks for your build environment">
  <img className="block dark:hidden" alt="Select Nixpacks for your build environment" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-build-nixpacks-light.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=56e5b009246003d3299a379fb2710778" width="1580" height="1302" data-path="images/update-build-nixpacks-light.png" />

  <img className="hidden dark:block" alt="Select Nixpacks for your build environment" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-build-nixpacks-dark.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=4431bd44bd74073156f4b3b464e0fd8f" width="1578" height="1318" data-path="images/update-build-nixpacks-dark.png" />
</Frame>

#### Buildpacks

Use [Buildpacks](/applications/build-options/buildpacks) to create a container for your application based on your repository.

* **Cache enabled:** When you build your application, Sevalla creates a deployable image from your code. By default, cache is enabled, which stores the latest successful deployment so that future builds can reuse unchanged components, significantly speeding up the process and reducing resource usage.
* **Build path:** This is the path in the repository to the files required to build the application. Most applications are built from the repository root, and the **Build path** defaults to this (.). If you have a different build path, specify it here. For example, if your application needs to be built from a subdirectory named **app**, enter **app** in the **Build path** field. This is also useful if you have a [monorepo](/applications/reference/glossary#monorepo).
* **Pack builder:** Choose which buildpack builder you want to use. For information about what each builder includes, refer to [Heroku stacks](https://devcenter.heroku.com/categories/stacks).
* **Add buildpack:** Add the required buildpacks for your application. The buildpack that contains the primary language of your application must be the last one in the buildpacks list. For example, if you have a Node.js application and need to add another buildpack, make sure the Node.js buildpack is at the end of the list.

<Frame caption="Select Buildpacks for your build environment.">
  <img className="block dark:hidden" alt="Select Buildpacks for your build environment" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-build-buildpacks-light.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=38ba000a511cb96e363788fb12875cfd" width="1584" height="1454" data-path="images/update-build-buildpacks-light.png" />

  <img className="hidden dark:block" alt="Select Buildpacks for your build environment" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-build-buildpacks-dark.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=9401891bf56c0832485b87e035568982" width="1590" height="1434" data-path="images/update-build-buildpacks-dark.png" />
</Frame>

#### Dockerfile

Use a [Dockerfile](/applications/build-options/dockerfile) (stored in your repository) to create a container for your application.

* **Cache enabled:** When you build your application, Sevalla creates a deployable image from your code. By default, cache is enabled, which stores the latest successful Docker image so that future builds can reuse unchanged components, significantly speeding up the process and reducing resource usage.
* **Dockerfile path:** This is the path to your Dockerfile relative to the repository root. For example, if your Dockerfile is in the repository root, enter **Dockerfile** in that field. If your Dockerfile is in a subdirectory named **app**, enter the path to the Dockerfile: **app/Dockerfile**.
* **Docker context:** This is the path in the repository we need access to so we can build your application. Most applications are built from the repository root, and you can enter the repository root (**.**) in the **Context** field. For example, if your application needs to be built from a subdirectory named **app**, enter **app** in the **Context** field.
* **Docker Registry Credential:** This is only required for private Docker images. You must enter your registry credentials within **Integration** > **Registry credentials**. Once you've entered your credentials in the Company settings, you can choose which credentials you want to use.

<Frame caption="Select Dockerfile for your build environment.">
  <img className="block dark:hidden" alt="Select Dockerfile for your build environment" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-build-dockerfile-light.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=b31b3cb6c6b5734264e041c97d64629c" width="1580" height="1528" data-path="images/update-build-dockerfile-light.png" />

  <img className="hidden dark:block" alt="Select Dockerfile for your build environment" src="https://mintcdn.com/sevalla/baqdBBXED5ZFGUpu/images/update-build-dockerfile-dark.png?fit=max&auto=format&n=baqdBBXED5ZFGUpu&q=85&s=d99f81e60041594a52e1fdfcac03f532" width="1588" height="1500" data-path="images/update-build-dockerfile-dark.png" />
</Frame>

If you change the environment, you must manually deploy your application again, which you can do on the [Deployments page](/applications/deployments/).

## Danger zone

<Frame caption="Danger zone settings for your application.">
  <img className="block dark:hidden" alt="Danger zone settings" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-danger-zone-light.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=14cee38e75925a5a1acee6b0efca0cc8" width="2554" height="524" data-path="images/settings-danger-zone-light.png" />

  <img className="hidden dark:block" alt="Danger zone settings" src="https://mintcdn.com/sevalla/9KWG8YmXXZKff_PH/images/settings-danger-zone-dark.png?fit=max&auto=format&n=9KWG8YmXXZKff_PH&q=85&s=6e2de68e7fb8d2999895a96b93640029" width="2560" height="530" data-path="images/settings-danger-zone-dark.png" />
</Frame>

<Info>
  Only Company Owners and Company Administrators can suspend, resume, or delete an Application. For information about how to change a user's access, refer to User Management.
</Info>

### Suspend or Activate app

There may be times when you need to stop an application without deleting it. This can be useful if you need to troubleshoot issues or test parts of the application without it running.

Suspending the application doesn't change or remove anything from it. Connections to the application remain in place but will not work while the application is suspended. You will not incur any costs for the application during the suspension.

Click **Suspend app** and confirm the suspension by clicking **Continue**.

When you're ready to restart your application, click **Activate app** and confirm the restart by clicking **Continue**.

### Delete app

If you no longer need the application, click **Delete app** and click **Continue** to remove it completely.

Deleting the application **completely removes** the following:

* All files
* Settings
* Persistent storage disks
* Connections to other applications or databases.
