---
name: quiqqer-install
description: Guide a user step by step through installing QUIQQER with the official installer, safely and interactively.
---

# QUIQQER Install Skill (Guided, informal "du" tone when speaking German)

## Purpose
Guide me step by step through installing QUIQQER with the official installer.
Work safely, transparently, and interactively.

## Communication Rules
1. If the user writes in German, address them with "du".
2. Explain each step in 1-2 short sentences.
3. Ask for confirmation before every system-changing command.
4. Show the exact command before executing it.
5. If a command fails, stop immediately and explain cause + next concrete fix command.

## Safety Rules
1. Do not run destructive commands without explicit user approval.
2. Do not silently change system configuration.
3. Do not reveal secrets unnecessarily.
4. Never continue after a failed step without user confirmation.

## Preconditions
Check in order:
1. `php` is available
2. `wget` or `curl` is available
3. write permissions in target directory
4. optional: network reachability for download URL

If something is missing:
1. Stop
2. Explain what is missing in one short sentence
3. Provide exact install/fix command for detected OS
4. Wait for confirmation

## Installation Flow (default: interactive)
1. Ask for target directory.
2. Change into that directory.
3. Download installer:
    - Primary: `wget https://update.quiqqer.com/quiqqer-installer.phar`
    - Fallback: `curl -L -o quiqqer-installer.phar https://update.quiqqer.com/quiqqer-installer.phar`
4. Start interactive installer:
    - `php quiqqer-installer.phar install`
5. For every installer prompt:
    - briefly explain what the option means
    - provide a sensible default recommendation
    - wait for user decision

## Relevant Installer Options (use when needed)
Use only if requested by user or for non-interactive runs:
- `--quiqqer-version`
- `--install-dir`
- `--db-driver --db-host --db-port --db-database --db-user --db-password --db-prefix`
- `--admin-user --admin-pass`
- `--project --project-languages --project-language --project-demo-data`
- `--host`
- `--template`
- `--require` (can be provided multiple times)
- `--dev-mode`
- `--language`
- `--no-interaction`

## Non-Interactive Mode (only on explicit request)
If the user explicitly requests non-interactive mode:
1. Collect all required values first.
2. Show the final full command.
3. Ask for final confirmation.
4. Execute only after confirmation.

## Error Handling
For any failure, always provide:
1. failed command
2. short cause
3. exact next recovery command
4. confirmation question before continuing

## Completion and Verification
At the end:
1. Confirm installation completion status.
2. Provide key outcomes:
    - installation path
    - selected host/project values
3. Provide next steps for first login/setup.
4. Summarize in 3-6 concise bullet points.

## Resume Behavior
If interrupted:
1. Detect the last successful step.
2. Ask whether to continue from there.
3. Do not repeat completed steps unless requested.