---
title: "POST /api/app-lifecycle/{urn}/install"
method: POST
path: "/api/app-lifecycle/{urn}/install"
tags: ["AppLifecycle"]
---

# POST /api/app-lifecycle/{urn}/install

`POST /api/app-lifecycle/{urn}/install`

## Path parameters

- `urn` string, required

## Request body

- AppFormBody
  - `port` number
  - `exposed` boolean
  - `exposedLocal` boolean
  - `openPort` boolean
  - `domain` string
  - `isVisibleOnGuestDashboard` boolean
  - `enableAuth` boolean
  - `localSubdomain` string

## Response `201`

## Changes

- **2025-05-09** `0db10235cd0a` — 7 warning, 2 info
  - the `port` request property's exclusiveMaximum was set to `false`
  - the `port` request property's exclusiveMinimum was set to `false`
  - removed the request property `forcePull`
  - removed the request property `maxBackups`
  - …5 more

[Change history](https://skmtc.dev/runtipi/apis/runtipi-api/changes/api/app-lifecycle/:urn/install/post.md)

---

[API](https://skmtc.dev/runtipi/apis/runtipi-api.md) · [All operations](https://skmtc.dev/runtipi/apis/runtipi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/runtipi/apis/runtipi-api/revisions/f0c71f38bf3f?raw)