> For the complete documentation index, see [llms.txt](https://documentation.astera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.astera.com/astera-data-stack-v10/project-management-and-scheduling/project-management/deployment.md).

# Deployment

*Deployment* is a way for setting up Astera projects to run on the [*Scheduler*.](/astera-data-stack-v10/project-management-and-scheduling/job-scheduling/scheduling-jobs-on-the-server.md)

When you are deploying a project, you can also specify parameters by creating a config file for project archive (.car) files to run project flows independent of any local parameters.

In this document, we will learn how to deploy projects in Astera.

### How to deploy a project on the Astera Server

1. Go to *Server > Server Explorer*. This will open a Server Explorer panel.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FqOiZ9KmnnOm2WnoMEtpc%2F1_server.png?alt=media\&token=fc267378-e182-4e44-a2c8-c8fa7693d3d2)

2. On the Server Explorer panel, right-click on the *DEFAULT* server node, and select *Cluster Settings*.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FveV9NYPcgHa7STDY1at7%2F2_cluster_settings.png?alt=media\&token=59699025-a192-4fd6-88d6-42a052d15ff5)

This will direct you to the general settings tab.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FECbasIblFHrRyOWEsUxH%2F3_window.PNG?alt=media\&token=6c60b477-2644-4034-b4ee-89e0e7b9e3e6)

3. In the general settings tab, specify the *Deployment Directory* path. The *Deployment Directory* is the location where the deployment files will be stored for the server to access when a deployment schedule is run.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FlQrYgEu9Hq7q7h7a8qX6%2F4_directory.png?alt=media\&token=31daa63f-2a3d-4fc8-bf0c-d8079c30b18a)

4. Now, open the project that you want to deploy on Astera’s Server by going to *Project > Open* and direct it to the .cprj file. This will open the selected project in the Project Explorer panel.

{% hint style="info" %}
**Note:** .cprj file refers to an Astera project file.
{% endhint %}

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FPYTvaZBMfDX1P8t27LUi%2F5_open_project.png?alt=media\&token=d8b602df-4b49-4982-af0a-a04cc803aaf2)

5. In the Project Explorer panel, right-click on the *Project* node, and select *Build Archive (.Car) for the Project* from the context menu.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2Fu5fXnFDkl8Je65rRkV8Q%2F6_archive.png?alt=media\&token=0f25e73d-3d19-43c4-8c9a-f65eff95ac7d)

6. Save this archive file on your system.
7. Now, open the *Deployment* window. Go to *Server > Deployment.*

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2Fu4GThZ6men6ABAHiRVTo%2F7_deployment.png?alt=media\&token=bdeaf5ca-bdd2-4271-a296-b499c3249aaf)

This will direct you to the main *Deployment* screen.

8. Click the *Add Deployment* icon to add a new deployment.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2F3oPsLfM76Erf2pj1IBvA%2F8_add.png?alt=media\&token=f0112a4f-0923-4991-887f-e2684c55651d)

9. Configure deployment settings by providing the following details:

* *Name*
* *Archive File Path* (\*.car)
* *Config File Path* (an optional file to specify project parameters)
* *Comment* (**optional**)

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FhfXgHht6k7r839CtbSsS%2F9.PNG?alt=media\&token=da80997a-2085-4300-a48e-473b4f93f9c9)

10. Save this deployment by clicking the *Save Deployment* icon ![11\_save](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FNkdPzxlKUNA51wcHbkAc%2F11_save.PNG?alt=media\&token=94f0c3ca-970b-4f31-a703-afac9354f43b) and it will be added to the list of deployed projects.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FCYhBR4qCPLIRAHppHUCG%2F10_add.png?alt=media\&token=3fd8c7b5-f656-458a-93cd-fdc167d6ad1a)

Multiple deployments can be configured on the cluster from the deployment window. The top part of the deployment screen shows the configured deployment files.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FBxxi0WXIbc6SOKMv0SuB%2F12_grid.PNG?alt=media\&token=0ea04648-e5ec-4c5d-ab6b-de4e819a856e)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.astera.com/astera-data-stack-v10/project-management-and-scheduling/project-management/deployment.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.