# Nextcloud

Technische Knowledge-Base-Einträge, kuratiert aus Obsidian durch Hermes.

# Knowledge Base

Aktive technische Knowledge-Base-Einträge aus Obsidian.

# Nextcloud – Tray Icon unter GNOME unsichtbar

---

tags:

- nextcloud
    
- debian
    
- gnome
    
- linux
    
- troubleshooting
    
- status-tray  
    os: Debian 13 Trixie  
    application: Nextcloud Desktop  
    status: solved
    

---

## Nextcloud – Tray Icon unter GNOME unsichtbar

> **success:** Lösung  
> Die von Nextcloud verwendeten `state-*` Icons waren für GNOME nicht über das allgemeine Icon-Theme verfügbar.
> 
> Die vorhandenen Icons nach `hicolor` kopieren und den Icon-Cache aktualisieren:
> 
> ```bash
> sudo mkdir -p /usr/share/icons/hicolor/scalable/status
> 
> sudo cp /usr/share/icons/WhiteSur/status/24/state-*.svg \
>   /usr/share/icons/hicolor/scalable/status/
> 
> sudo gtk-update-icon-cache -f /usr/share/icons/hicolor
> ```
> 
> Danach Nextcloud neu starten:
> 
> ```bash
> killall nextcloud
> nextcloud &
> ```

### Umgebung

|Komponente|Version|
|---|---|
|OS|Debian 13 Trixie|
|Desktop|GNOME 48.7|
|Session|Wayland|
|Nextcloud|3.16.7-1~deb13u1|
|Qt|6.8.2|
|GNOME Extension|Status Tray|

---

### 🐛 Fehlerbild

Nextcloud läuft und synchronisiert normal.

Im GNOME Panel ist der **Tray-Eintrag vorhanden**, das eigentliche Nextcloud-Icon ist jedoch **unsichtbar**.

Andere Tray-Anwendungen wie NetBird oder Remmina werden korrekt dargestellt.

---

### 🔍 Diagnose

#### 1. Prüfen, ob Nextcloud im Status Tray registriert ist

```bash
busctl --user get-property \
  org.kde.StatusNotifierWatcher \
  /StatusNotifierWatcher \
  org.kde.StatusNotifierWatcher \
  RegisteredStatusNotifierItems
```

Nextcloud war korrekt als `StatusNotifierItem` registriert.

Der relevante Eintrag lieferte:

```text
Title    = "Nextcloud"
IconName = "state-warning"
Status   = "Active"
```

> **info:** Erkenntnis  
> Nextcloud selbst und die **Status Tray Extension funktionieren**.
> 
> Nextcloud fordert lediglich ein Icon mit dem Namen `state-warning` an.

#### 2. Icon auf dem System suchen

```bash
find /usr/share/icons ~/.local/share/icons ~/.icons \
  -type f \( -iname 'state-warning.*' -o -iname '*state-warning*' \) \
  2>/dev/null
```

Gefunden wurde das Icon nur im **WhiteSur Theme**:

```text
/usr/share/icons/WhiteSur-light/status/16/state-warning.svg
/usr/share/icons/WhiteSur-light/status/22/state-warning.svg
/usr/share/icons/WhiteSur-light/status/24/state-warning.svg

/usr/share/icons/WhiteSur/status/16/state-warning.svg
/usr/share/icons/WhiteSur/status/22/state-warning.svg
/usr/share/icons/WhiteSur/status/24/state-warning.svg
```

---

### 💡 Ursache

Nextcloud liefert über StatusNotifier nicht zwingend das eigentliche Bild, sondern einen **Icon-Namen**:

```text
state-warning
```

GNOME bzw. Status Tray versucht anschließend, dieses Icon über das Icon-Theme zu laden.

Die benötigten `state-*` Icons waren auf dem System zwar vorhanden, aber nur innerhalb von **WhiteSur**.

Sie fehlten im allgemeinen Fallback:

```text
/usr/share/icons/hicolor/
```

Dadurch entstand:

> **Tray-Eintrag vorhanden → Icon kann nicht aufgelöst werden → Icon unsichtbar**

---

### 🔧 Dauerhafter Fix

Nextcloud verwendet je nach Zustand verschiedene Icons. Deshalb nicht nur `state-warning.svg`, sondern alle `state-*` Icons übernehmen.

Vorhandene Icons:

```text
state-information.svg
state-pause.svg
state-ok.svg
state-error.svg
state-sync.svg
state-offline.svg
state-download.svg
state-warning.svg
```

Alle nach `hicolor` kopieren:

```bash
sudo mkdir -p /usr/share/icons/hicolor/scalable/status

sudo cp /usr/share/icons/WhiteSur/status/24/state-*.svg \
  /usr/share/icons/hicolor/scalable/status/

sudo gtk-update-icon-cache -f /usr/share/icons/hicolor
```

Nextcloud neu starten:

```bash
killall nextcloud
nextcloud &
```

> **success:** Ergebnis  
> Das Nextcloud Tray Icon wird wieder korrekt angezeigt und bleibt auch bei einem Wechsel des Synchronisationsstatus sichtbar.

---

### 🧪 Kontrolle

Prüfen, ob die Icons im Fallback vorhanden sind:

```bash
ls -l /usr/share/icons/hicolor/scalable/status/state-*.svg
```

Status des aktuell von Nextcloud verwendeten Icons kann über D-Bus geprüft werden:

```bash
busctl --user get-property \
  org.kde.StatusNotifierWatcher \
  /StatusNotifierWatcher \
  org.kde.StatusNotifierWatcher \
  RegisteredStatusNotifierItems
```

---

### ⚠️ Nach Updates

> **warning:** > Bei Änderungen am Icon-Theme oder entsprechenden Paketupdates kann es sinnvoll sein zu prüfen, ob die kopierten `state-*` Icons weiterhin vorhanden sind.

```bash
ls /usr/share/icons/hicolor/scalable/status/state-*.svg
```

---

### TL;DR

**Problem**

```text
Nextcloud läuft → Tray-Eintrag vorhanden → Icon unsichtbar
```

**Ursache**

```text
Nextcloud → IconName "state-*"
                ↓
       aktives Icon-Theme
                ↓
          Icon fehlt
                ↓
        unsichtbares Icon
```

**Fix**

```bash
sudo cp /usr/share/icons/WhiteSur/status/24/state-*.svg \
  /usr/share/icons/hicolor/scalable/status/

sudo gtk-update-icon-cache -f /usr/share/icons/hicolor
```

---

*Quelle: Obsidian `Knowledge Base/Nextcloud/Nextcloud – Tray Icon unter GNOME unsichtbar.md` · Stand: 2026-08-14 · Automatisiert publiziert durch Hermes.*