---
title: "Academy Article"
canonical_url: "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment"
locale: en
meta:
  "og:title": "Academy Article"
---

[Go to home](https://academy.laioutr.com/en)

- [Hosting and operations](https://academy.laioutr.com/en/bereiche/hosting-and-operations)

- [Deployment](https://academy.laioutr.com/en/leitfaeden/deployment)

- [Start and check a deployment](https://academy.laioutr.com/en/artikel/start-and-check-a-deployment)

# Start and check a deployment

A deployment rebuilds the storefront of an environment and puts changes to apps, versions and configuration live. It is started in Cockpit under Deployments with Deploy; the status and build log show whether it worked.

## Before you start

<dl>

<dt>Plan</dt>
<dd>Laioutr Cloud or a connected hosting option</dd>

<dt>Role</dt>
<dd>Access to the project in Cockpit with permission to deploy</dd>

<dt>Duration</dt>
<dd>5 min</dd></dl>

### Prerequisites

- Saved changes to apps, versions or configuration

Last reviewed on October 15, 2026

A **deployment** builds the storefront of an environment and puts the result live. It is needed whenever something that goes into the build has changed: adding or removing apps, app and platform versions, app settings, new markets or other project configuration. Saving in Cockpit only sets what the next deployment installs; the running site stays unchanged until then.

The overview under **Deployments** lists all deployments of the project, newest first. Each row shows the environment, time, who triggered it, status and URL. The active deployment of an environment carries the **Current** badge. The table updates in real time.

A build may run for at most 20 minutes; a working build finishes within a few minutes. A failed build is not retried automatically. A deployment only affects its own environment, so deploying stage changes nothing on main.

## Step by step

1. 1 ### Step 1: Open Deployments Open **Deployments** from the project sidebar in Cockpit.
2. 2 ### Step 2: Start the deployment Click **Deploy** to build the main environment. For another environment, select **Deploy** on its card under **Environments**.
3. 3 ### Step 3: Follow the status The **Status** column moves from preparing through waiting and running to success or error. Reloading the page is not necessary.
4. 4 ### Step 4: Open the details Click the environment name in the row. The detail view shows status, provider, duration, who triggered it and the URL.
5. 5 ### Step 5: Read the build log Expand the **Build log** section. New lines appear while the build runs; if loading fails, select **Retry**.
6. 6 ### Step 6: Check the result Open the new version via the deployment URL and check the pages that changed.

## Check the result

The new deployment is listed with status success and the Current badge, and the storefront shows the change. On error, the build log names the cause; after fixing it, start a new deployment.

## Frequently asked questions

When is a deployment needed?

When apps, app versions, app settings, the platform version, markets or other project configuration have changed. These values are built into the image and apply from the next deployment.

Why are canceled deployments not shown?

The filter hides the canceled status by default. Add canceled in the status filter to show them.

What does a stop after 20 minutes mean?

The build reached the time limit and is treated as stuck. The build log shows where it stopped.

Does deploying stage change the live site?

No. A deployment only affects its own environment. Other environments stay unchanged.

## Related

- [Understanding the main, dev and stage environments](https://academy.laioutr.com/en/artikel/understanding-main-dev-and-stage-environments)5 min

  Every project starts with the main environment, which is the live storefront. Further environments such as stage or dev run beside it as separate copies with their own address, pages, apps and deployments until their work is promoted to main.
- [Compare and roll back deployments](https://academy.laioutr.com/en/artikel/compare-and-roll-back-deployments)5 min

  Every deployment has its own address, so two versions can be compared side by side. A rollback puts an already built earlier production deployment live again within seconds, without a new build.
- [Read storefront logs](https://academy.laioutr.com/en/artikel/read-storefront-logs)6 min

  Under Logs, Cockpit shows what the storefront of each environment on Laioutr Cloud writes, plus an access log. Each line's level comes from the console method that was called, and a trace finds all lines of one request.
- [Go-live checklist](https://academy.laioutr.com/en/artikel/go-live-checklist)10 min

  Before going live, five areas are checked: account, project, markets and languages; the tested app connection; published pages including legal pages; SEO basics and redirects; and finally deployment, custom domain and removing password protection.

## Learn it in a lesson

- [Check the deployment status](https://academy.laioutr.com/en/lektionen/foundations-deployment-status)7 min
- [Environments and deployment](https://academy.laioutr.com/en/lektionen/developer-environments-and-deployment)12 min
- [Start and check a deployment](https://academy.laioutr.com/en/lektionen/go-live-start-and-check-a-deployment)7 min

## [Deployment](https://academy.laioutr.com/en/leitfaeden/deployment)

Search this guide

1. [Understanding the main, dev and stage environments](https://academy.laioutr.com/en/artikel/understanding-main-dev-and-stage-environments)5 min
2. [Start and check a deployment](https://academy.laioutr.com/en/artikel/start-and-check-a-deployment)5 min
3. [Compare and roll back deployments](https://academy.laioutr.com/en/artikel/compare-and-roll-back-deployments)5 min
4. [Read storefront logs](https://academy.laioutr.com/en/artikel/read-storefront-logs)6 min
5. [Bring Your Own Server: host the storefront in-house](https://academy.laioutr.com/en/artikel/bring-your-own-server-host-the-storefront-in-house)7 min In preparation

## Structured Data

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@id": "https://academy.laioutr.com/#website",
      "@type": "WebSite",
      "inLanguage": "en",
      "name": "Default",
      "url": "https://academy.laioutr.com/",
      "translationOfWork": {
        "@id": "https://academy.laioutr.com/#website"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#webpage",
      "name": "Academy Article",
      "url": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment",
      "@type": [
        "WebPage",
        "FAQPage"
      ],
      "breadcrumb": {
        "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#breadcrumb"
      },
      "isPartOf": {
        "@id": "https://academy.laioutr.com/#website"
      },
      "mainEntity": [
        {
          "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/1"
        },
        {
          "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/2"
        },
        {
          "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/3"
        },
        {
          "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/4"
        }
      ],
      "potentialAction": [
        {
          "@type": "ReadAction",
          "target": [
            "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment"
          ]
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#breadcrumb",
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "name": "Home",
          "item": "https://academy.laioutr.com/en",
          "position": 1
        },
        {
          "@type": "ListItem",
          "name": "Hosting and operations",
          "item": "https://academy.laioutr.com/en/bereiche/hosting-and-operations",
          "position": 2
        },
        {
          "@type": "ListItem",
          "name": "Deployment",
          "item": "https://academy.laioutr.com/en/leitfaeden/deployment",
          "position": 3
        },
        {
          "@type": "ListItem",
          "name": "Start and check a deployment",
          "item": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment",
          "position": 4
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/1",
      "@type": "Question",
      "inLanguage": "en",
      "name": "When is a deployment needed?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>When apps, app versions, app settings, the platform version, markets or other project configuration have changed. These values are built into the image and apply from the next deployment.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/2",
      "@type": "Question",
      "inLanguage": "en",
      "name": "Why are canceled deployments not shown?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>The filter hides the canceled status by default. Add canceled in the status filter to show them.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/3",
      "@type": "Question",
      "inLanguage": "en",
      "name": "What does a stop after 20 minutes mean?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>The build reached the time limit and is treated as stuck. The build log shows where it stopped.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/artikel/start-and-check-a-deployment#/schema/question/4",
      "@type": "Question",
      "inLanguage": "en",
      "name": "Does deploying stage change the live site?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>No. A deployment only affects its own environment. Other environments stay unchanged.</p>"
      }
    }
  ]
}
```