# Local Installation And First Start

## Area

- Route: local application start
- Purpose: install the app locally and verify the first launch

## When you use this page

Use this guide when:

- the app is started on a new machine
- a ZIP release was unpacked manually
- Python and the local runtime environment need to be checked
- support needs a reproducible first-start workflow

## Important requirements

- Python is installed
- the ZIP release was unpacked completely
- the app folder stays together as one directory
- the first start is allowed to create the database automatically

## Step-by-step guide

### Step 1: Prepare the release

1. Download the current release package.
2. Unpack the ZIP completely.
3. Keep the full folder structure together.

### Step 2: Check Python

1. Open a terminal in the app folder.
2. Verify that Python is available.
3. Install missing packages if needed.

### Step 3: Start the app locally

1. Run the local start command or the provided launcher.
2. Wait until the web server reports that it is ready.
3. Open the app in the browser.

### Step 4: Verify the first launch

1. Check dashboard, settings and navigation.
2. Confirm that the database and runtime folders were created.
3. Review the browser for obvious startup problems.

## Common issues

- the ZIP was not fully extracted
- Python is missing or uses the wrong version
- the app was started from the wrong folder
- the first launch was stopped before the database was created
