Skip to content

Commit

Permalink
docs(readme): add a troubleshooting section for timeout issue
Browse files Browse the repository at this point in the history
  • Loading branch information
Lebe1ge committed Dec 10, 2024
1 parent 5a72efd commit d90271d
Show file tree
Hide file tree
Showing 3 changed files with 55 additions and 1 deletion.
28 changes: 27 additions & 1 deletion README-fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,12 +154,38 @@ Une fois l'installation terminée, voici comment configurer et accéder à Linus
4. Pendant la configuration, sélectionnez une entité météo ou d’alarme si nécessaire (ces étapes sont facultatives).
5. Une fois la configuration terminée, un nouvel **icône avec un nœud papillon** apparaîtra dans le menu de gauche. Cliquez dessus pour accéder directement à Linus Dashboard.


#### ✨ Astuce
- Si l’icône n’apparaît pas immédiatement, essayez de redémarrer Home Assistant une nouvelle fois.

---

### ❗ Dépannage

#### Résolution des erreurs de timeout ou des messages d’erreur en rouge

Si vous rencontrez un message d’erreur comme celui-ci en essayant d’utiliser Linus Dashboard :

![Erreur de Timeout](https://github.com/Thank-you-Linus/Linus-Dashboard/blob/main/images/timeout-error.png)

**Suivez ces étapes pour résoudre le problème** :

1. **Videz votre cache** :
- Pour les navigateurs : Videz le cache de votre navigateur.
- Pour l’application mobile Home Assistant : Effacez le cache de l’application via les paramètres de votre appareil.
- Si vous utilisez un proxy inverse ou un service DNS comme Cloudflare : Videz également le cache là-bas.

2. **Forcez un rafraîchissement** :
- Sur **Windows** : Appuyez sur `CTRL + F5`.
- Sur **Mac** :
- Maintenez `⇧ Shift` et cliquez sur le bouton Recharger.
- Ou maintenez les touches `⌘ Cmd` et `⇧ Shift`, puis appuyez sur `R`.

3. **Vérifiez votre configuration** : Assurez-vous que votre instance Home Assistant est correctement configurée et qu’il n’y a pas de problèmes liés au réseau.

Si ces étapes ne résolvent pas le problème, n’hésitez pas à ouvrir une issue sur le [dépôt GitHub](https://github.com/Thank-you-Linus/Linus-Dashboard/issues) en fournissant des détails sur votre configuration et le message d’erreur.

---

## 📣 Rejoignez notre communauté

- 🌟 **Montrez votre soutien** : [GitHub Stars](https://github.com/Thank-you-Linus/Linus-Dashboard/stargazers)
Expand Down
28 changes: 28 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,34 @@ After installation, follow these steps to configure and access Linus Dashboard:
#### ✨ Tip
- If the icon doesn’t appear immediately, try restarting Home Assistant again.


---

### ❗ Troubleshooting

#### Fixing Timeout or Red Error Messages

If you encounter an error message like the one below when trying to use Linus Dashboard:

![Timeout Error](https://github.com/Thank-you-Linus/Linus-Dashboard/blob/main/images/timeout-error.png)

**Follow these steps to resolve the issue**:

1. **Clear your cache**:
- For browsers: Clear your browser cache.
- For the Home Assistant mobile app: Clear the app cache via your device settings.
- If you're using a reverse proxy or a DNS service like Cloudflare: Clear the cache there as well.

2. **Force a refresh**:
- On **Windows**: Press `CTRL + F5`.
- On **Mac**:
- Hold `⇧ Shift` and click the Reload button.
- Or, hold down `⌘ Cmd` and `⇧ Shift` key, then press `R`.

3. **Check your setup**: Ensure your Home Assistant instance is correctly set up and that there are no network-related issues.

If these steps don’t resolve the issue, feel free to open an issue on the [GitHub repository](https://github.com/Thank-you-Linus/Linus-Dashboard/issues) with details about your setup and the error message.

---

## 📣 Join Our Community
Expand Down
Binary file added images/timeout-error.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit d90271d

Please sign in to comment.