---
title: "Deploy Frontend Apps | Hostman Docs"
description: "Learn how to deploy frontend apps on Hostman App Platform with ease. Follow step-by-step guides for seamless deployment."
---

> For the complete documentation index for AI agents, see [llms.txt](https://hostman.com/llms.txt).

To deploy a frontend application on Hostman, go to the [App Platform](https://hostman.com/app-platform/) section and click **Create App**.

## Step 1. Application Type

On the **Frontend** tab, your framework and the desired Node.js version.

![855d2287 088f 4226 8b11 7cf8592ea9e9](https://content.hostman.com/assets/62b4dc69-c5d3-4834-b515-28baeedb22ce.png?width=757&height=784)

## Step 2. Repository and Branch

You can connect a repository:

-   From your GitHub, GitLab, or BitBucket account. Click on the platform name, log in and select the desired repository. If you are already logged in, Hostman will immediately show the available repositories.
    
-   By URL, providing a link to a repository created on any platform. Click **Connect the repository via URL** and enter the Git URL of the repository. If the repository is private, also enter the access details.
    

Read more about connecting repositories [here](https://hostman.com/docs/app-platform/connecting-repositories).

Next, select a branch for deployment. The menu displays the 200 most recent branches, as well as the default branch (`master`, `main`, or `default`) if the repository is connected via GitHub, GitLab, or Bitbucket.

By default, we enable the **Build by the last executed commit** option. In this case, the App platform will deploy the latest commit, and later will automatically rebuild the application when you add new commits to the repository. If necessary, you can [disable automatic deployment](https://hostman.com/docs/app-platform/managing-apps/#autodeploy) in the future.

If you want to select a specific commit manually, disable this option.

![F6b35657 2cf3 476c B9b9 94fc424944bc](https://content.hostman.com/assets/a0e220a9-2f21-4364-9199-3f1bc722c8bd.png?width=759&height=708)

## Step 3. Server Location and Configuration

Select the server location.

![Config and Location](https://content.hostman.com/assets/0d4997bd-1a45-48c4-bf05-9ca2d49ffb29.png?width=751&height=738)

Each frontend application is allocated 2 GB of NVMe disk space. Server configuration cannot be customized. Applications are billed [based on resource usage](https://hostman.com/docs/app-platform/billing/).

For [Nuxt](https://hostman.com/docs/app-platform/frontend-apps/nuxt/#ssr-support) and [Next.js](https://hostman.com/docs/app-platform/frontend-apps/nextjs/#ssr-support) apps, you can enable SSR support, which allows you to choose a server configuration, as with [backend applications](https://hostman.com/docs/app-platform/backend-apps/).

![05466c8f 91c4 47eb 826c 3deb7c6041e2](https://content.hostman.com/assets/163657f2-d38a-42d0-9711-8affb87fdbec.png?width=746&height=713)

## Step 4. App Settings

At this stage, you can define the build command, install the required dependencies, specify the build directory, the project directory, and set environment variables.

![7698c6f3 7b88 42bd 9651 37b2d11e1dc9](https://content.hostman.com/assets/630ad362-ad77-4201-8fef-c28c95cff68f.png?width=635&height=619)

#### Build Command and Build Directory

The App Platform will automatically suggest a build command and build directory for your project. You can edit them if necessary, but in most cases no changes are required.

The **Build Directory** parameter does not change the directory from which the build command is executed. Instead, it specifies the path (relative to the repository root) to the directory that will contain the built artifacts, such as `index.html`.

If both **Build Directory** and **Project Directory** are specified, the final path used to serve the site files is constructed as:

```shell
/<Project Directory>/<Build Directory>
```

For example:

-   Project Directory: `/apps/frontend`
-   Build Directory: `/dist`

In this case, the files will be served from the `/apps/frontend/dist` directory.

#### Project Directory

By default, the build command runs from the root of the repository. If your project files, including `package.json`, are located in a subdirectory (for example, `/apps/frontend`), specify the path to that directory relative to the repository root in the **Project directory path** field.

When a path is specified:

-   The working directory switches to the specified folder.
-   Dependencies are installed using the project files located in that folder.
-   Build and run commands are also executed from that folder.

#### Dependencies

In the **Dependencies** section, you can specify system packages required, for example, to build the project. All listed packages will be passed to the `apt install` command. If you need to install multiple packages, list them separated by spaces.

#### Variables

You can also define [environment variables](https://hostman.com/docs/app-platform/variables/) if your project requires them.

You will be able to [change any of these settings](https://hostman.com/docs/app-platform/managing-apps/#deploying-with-new-parameters) later and re-run the deployment with the new parameters.

## Step 5. App Information

Here you can specify a name and a comment for your application to be displayed in the Hostman dashboard. You can also select a project to add the app to.

These settings can also be changed later.

![A54c58aa 1511 47aa Aec6 1b5226ded41d](https://content.hostman.com/assets/f948d784-670b-4d23-b7c3-3d831c0bd9be.png?width=718&height=446)

## Step 6. Deploy

Click **Create**. Once the process starts, you will see the deployment log on the **Deploy** tab.

The deploy log contains all the necessary information to solve possible issues. If something goes wrong, for example, due to errors in the code, the deploy log will display the notification about it specifying the cause of the problem.

When you first deploy a project, the server installation may take some time. Once the process is completed, the application status will be updated, and you will also see a message about this in the log.

All done!

You can find and copy your app’s URL (the technical domain that was linked to the app) on the main page of the **App Platform** section or in the **Settings** tab of your app. You can also [link your own domain](https://hostman.com/docs/app-platform/managing-apps/#linking-a-domain) to the app.

The application will run on ports 443 and 80.

In the future, the App platform will monitor updates in the repository and, if [automatic deployment](https://hostman.com/docs/app-platform/managing-apps/#autodeploy) is enabled, automatically rebuild the project with new changes.