# Premier démarrage

Une fois l'image lancée, ouvrez le port 23406 à l'adresse IP du serveur dans un navigateur et vous serez redirigé automatiquement vers l'assistant /setup. L'ensemble du premier démarrage prend généralement moins de 5 minutes.

## 1. Choisir un type de base de données

La première étape de l'assistant vous demande de choisir **SQLite** ou **MySQL/MariaDB** :

| Option | Idéal pour | Remarques |
| --- | --- | --- |
| **SQLite (par défaut recommandé)** | Déploiement domestique sur une seule machine | La base de données n'est qu'un fichier — zéro configuration, zéro maintenance |
| **MySQL/MariaDB** | Multi-machines / grande échelle / MySQL existant | Vous le déployez vous-même, ou choisissez « MariaDB intégré » pour que l'image en démarre un |

> **💡 Choisir SQLite n'a rien de honteux**
>
> SQLite suffit amplement pour moins de 200 caméras sur un seul serveur. Le goulot d'étranglement de performance est presque toujours l'E/S disque (enregistrement) et le GPU (détection), pas la base de données.

## 2. Créer le compte administrateur

Un nom d'utilisateur + un mot de passe (≥ 8 caractères, avec lettres et chiffres). Ce compte a le privilège le plus élevé dans le Web Admin — il peut supprimer des caméras et changer la configuration globale — utilisez donc un mot de passe fort.

> **⚠️ Que faire si vous oubliez le mot de passe administrateur**
>
> Il n'existe actuellement aucun outil de réinitialisation CLI intégré. Solution de contournement : ouvrez la base de données (SQLite via `sqlite3 data/skyview.db`, MySQL via `mysql -u skyview -p`) et exécutez `DELETE FROM users;` pour vider la table des utilisateurs ; rafraîchissez le navigateur et vous serez renvoyé vers l'assistant de configuration pour recréer le premier administrateur — les caméras, la bibliothèque de visages, les règles d'automatisation et les autres données ne sont pas affectées. Donc **retenez votre mot de passe**, ou conservez-le dans un gestionnaire de mots de passe.

## 3. Configuration terminée — accéder au Web Admin

Une fois la configuration écrite par l'assistant, le service redémarre automatiquement et vous redirige vers la page de connexion. Connectez-vous avec le compte que vous venez de créer pour accéder à l'accueil de la console.

## 4. Ajouter votre première caméra

Navigation gauche → Caméras → Ajouter. Deux méthodes de connexion sont prises en charge :

- **Découverte automatique ONVIF** (recommandée) : quand la caméra et le serveur sont sur le même réseau local, cliquez sur « Scanner » et tous les périphériques ONVIF s'affichent en quelques secondes
- **RTSP manuel** : collez une URL du type `rtsp://nomutilisateur:motdepasse@IPcamera:554/stream1`

> **ℹ️ La connexion ONVIF est recommandée**
>
> ONVIF obtient automatiquement les capacités PTZ, le port audio bidirectionnel et l'adresse du sous-flux, vous évitant de fouiller dans le manuel du fabricant. Les identifiants sont stockés chiffrés.

## 5. Voir la vidéo, c'est réussi

Après l'ajout, vous êtes redirigé vers la page Direct et devriez voir la vidéo en 3 à 8 secondes. Le canal à faible latence (< 500 ms) est privilégié et bascule automatiquement vers le canal stable (2 à 4 s) s'il ne se connecte pas.

> **⚠️ Bloqué sur la roue de chargement**
>
> Aucune vidéo signifie généralement : une URL RTSP incorrecte (mauvais mot de passe / chemin), un pare-feu bloquant le port UDP 23515, ou une caméra utilisant un protocole propriétaire (par ex. Tapo). Voir le [dépannage](/docs/troubleshooting).

## 6. Activer l'enregistrement (facultatif)

L'enregistrement est activé par défaut, écrit en segments temporels sous le répertoire de données. Pour le désactiver ou n'enregistrer que certaines plages horaires, allez dans Détails de la caméra → Paramètres d'enregistrement.

## Et ensuite

- Ajouter d'autres caméras → [Ajout de caméras](/docs/cameras)
- Regarder la relecture → allez simplement sur la page « Relecture » du Web Admin et faites glisser la chronologie
- Activer la détection IA (mouvement / visage / plaque d'immatriculation) → [Détection IA](/docs/detection)
- Rencontrer un problème → [Dépannage](/docs/troubleshooting)

---

来源:https://yun-kan.com/fr/docs/quickstart