﻿# Telepítés Linuxra (systemd és nginx)

> Az alkalmazás systemd szolgáltatásként fut egy külön felhasználó nevében, előtte nginx fordított proxyval. A parancsok Ubuntura és Debianra vonatkoznak; a Red Hat család (RHEL, CentOS Stream, Rocky, Alma, Oracle Linux) eltéréseit jelezzük. Linuxon Active Directory-s bejelentkezés nem érhető el;…

Source: https://workwise-solutions.net/hu/docs/installation/linux/ · Language: hu · English version: https://workwise-solutions.net/docs/installation/linux/

Az alkalmazás systemd szolgáltatásként fut egy külön felhasználó nevében, előtte nginx fordított proxyval. A parancsok Ubuntura és Debianra vonatkoznak; a Red Hat család (RHEL, CentOS Stream, Rocky, Alma, Oracle Linux) eltéréseit jelezzük. Linuxon Active Directory-s bejelentkezés nem érhető el; használja a helyi, LDAP, Entra ID vagy OAuth bejelentkezést.

![WorkSmartHub Linuxon, systemd szolgáltatásként nginx mögött](https://workwise-solutions.net/docs/images/diagram-install-linux-hu.png)
*Az nginx-en végződik a TLS, és a localhost:5000 címre továbbít, ahol az alkalmazás systemd szolgáltatásként fut.*

## 1. Futtatókörnyezet

```bash
# Ubuntu 24.04 és újabb
sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-10.0

# Ubuntu 22.04: a Canonical backports PPA-ja
sudo add-apt-repository -y ppa:dotnet/backports
sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-10.0

# Red Hat család
sudo dnf install -y aspnetcore-runtime-10.0
```

Debianon előbb regisztrálja a Microsoft csomagtárolóját. Csak egy csomagforrást használjon, és ellenőrizze a `dotnet --list-runtimes` paranccsal (`Microsoft.AspNetCore.App 10.0.x`). Ha az adatbázis, az SMTP-szerver, a Vault vagy az identitásszolgáltató belső hitelesítésszolgáltatótól (CA) kapott tanúsítványt használ, vegye fel a CA-t a rendszer megbízható tanúsítványai közé.

## 2. Az alkalmazás fájljai és felhasználója

```bash
# másolja a kiadás (publish) mappáját a /opt/worksmarthub mappába, majd:
sudo useradd --system --shell /sbin/nologin worksmarthub
sudo chown -R worksmarthub:worksmarthub /opt/worksmarthub
```

Az alkalmazás ebbe a mappába ír: `Logs/`, az SQLite adatbázis, `FileStorage/`, az élő sablonok és az `appsettings.json`.

## 3. systemd szolgáltatás

`/etc/systemd/system/worksmarthub-app.service`:

```ini
[Unit]
Description=WorkSmartHub
After=network.target

[Service]
Type=simple
Restart=always
RestartSec=3
User=worksmarthub
WorkingDirectory=/opt/worksmarthub
ExecStart=/usr/bin/dotnet /opt/worksmarthub/WorkSmartHub.dll
TimeoutStopSec=75
SyslogIdentifier=WorkSmartHub

[Install]
WantedBy=multi-user.target
```

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now worksmarthub-app
journalctl -t WorkSmartHub -f
```

A `WorkingDirectory` fontos, mert a relatív elérési utak ehhez képest értendők. A `TimeoutStopSec=75` időt ad az alkalmazásnak a rendezett leálláshoz.

## 4. Beállítás

Szerkessze az `/opt/worksmarthub/appsettings.json` fájlt ([Konfiguráció](https://workwise-solutions.net/hu/docs/installation/configuration/)), majd indítsa újra a szolgáltatást. nginx mögött hagyja a `HttpSettings.Urls` értékét `http://localhost:5000`-en; csak akkor írja át `http://+:5000`-re, ha az alkalmazást közvetlenül teszi elérhetővé. Portonként egy bejegyzést használjon.

## 5. nginx

```nginx
server {
    listen 443 ssl http2;
    server_name wsh.example.com;
    ssl_certificate     /opt/ssl/certificate.crt;
    ssl_certificate_key /opt/ssl/certificate.key;

    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}
```

A `http` blokkban állítsa be a `client_max_body_size 50m;` értéket (a feltöltések 25 MB-os darabokban érkeznek, az nginx alapértelmezett 1 MB-os korlátja ezeket elutasítja), és 600 másodperces időkorlátokat. Az nginx mindig írja felül a továbbított fejléceket, soha ne adja tovább a klienstől érkező értékeket. Red Hat családon SELinux mellett futtassa a `sudo setsebool -P httpd_can_network_connect 1` parancsot; firewalld esetén nyissa meg a http és https szolgáltatást.

Állítsa a `PublicBaseUrl` értékét a nyilvános címre.

## Frissítés

1. Ha a kiadás igényli, előbb telepítse az újabb .NET futtatókörnyezetet.
2. Készítsen mentést, majd: `sudo systemctl stop worksmarthub-app`.
3. Tegye félre az `appsettings.json` fájlt, másolja be az új fájlokat, tegye vissza, és futtassa: `chown -R worksmarthub:worksmarthub /opt/worksmarthub`.
4. Indítsa el a szolgáltatást; az adatbázist az alkalmazás induláskor migrálja.

Alternatívák: ugyanez az egység futhat **systemd felhasználói szolgáltatásként** is (a `loginctl enable-linger` paranccsal engedélyezze a lingeringet), vagy futtathatja az alkalmazást [Dockerben](https://workwise-solutions.net/hu/docs/installation/docker/).
