3.2.1. A Dolibarr és a Talerbarr telepítése parancssorból#

Fontos: Ez nem hivatalos Dolibarr-telepítési útmutató. Célja kizárólag a Talerbarr modul telepítésének teljes körű, végponttól végpontig tartó bemutatása, kifejezetten mappa alapú telepítéssel, nem pedig a Dolibarr felhasználói felületén vagy a Dolistore-on keresztüli telepítéssel.

Ez az oktatóanyag fejlesztői vagy rendszergazdai háttérrel rendelkező felhasználóknak készült. Ha még soha nem használt parancssori eszközöket, fontolja meg a Dolibarr beszerzésének egy felhasználóbarátabb módját, például a Dolibarr csapata által jóváhagyott SaaS-megoldást.

3.2.1.1. Van egy Debian kiszolgálója#

Mielőtt folytatná, győződjön meg róla, hogy rendelkezik egy futó Debian szerverrel sudo hozzáféréssel. Ehhez a telepítéshez a Dolibarr rootless Podman alatt fog futni normál felhasználóként, míg a sudo-t csak a csomagok telepítéséhez és a kezdeti rendszerbeállításhoz használjuk. A rootless Podman hivatalosan támogatott üzemmód, és az olyan felhasználói szolgáltatásokhoz, amelyeknek a kijelentkezés után is futniuk kell, és rendszerindításkor el kell indulniuk, a Podman/systemd útmutatás javasolja a lingering engedélyezését az adott felhasználónál.

3.2.1.2. Rendelkezzen DNS-bejegyzéssel#

Hozzon létre egy DNS-bejegyzést a domainregisztrátoránál vagy DNS-szolgáltatójánál:

Típus: A

Név: erp, dolibarr, vagy egy Ön által választott másik aldomain

Érték: A szerver nyilvános IP-címe

3.2.1.3. Podman telepítése#

Telepítse a Podmant és a rootless konténerekhez szükséges eszközöket:

sudo apt update
sudo apt upgrade -y
sudo apt install -y podman podman-compose uidmap slirp4netns fuse-overlayfs passt aardvark-dns

3.2.1.4. Hozzon létre egy dedikált felhasználót a Dolibarr számára#

Hozzon létre egy dedikált, jogosultságok nélküli felhasználót, amely birtokolni és futtatni fogja a Dolibarr-stacket:

sudo adduser --disabled-password --gecos "" dolibarr
sudo loginctl enable-linger dolibarr

A loginctl enable-linger parancs azért fontos, mert a felhasználói szintű systemd-szolgáltatások egyébként leállnak, miután az adott felhasználó utolsó munkamenete véget ér.

3.2.1.5. Hozzon létre egy fordított proxyt#

Természetesen szabadon beállíthatja az Önnek megfelelő módon is, itt többnyire nincs jó vagy rossz megoldás; ez a leírás csak azt mutatja be, hogyan készítettük elő a rendszert az oktatóanyag szövegének és képeinek elkészítéséhez.

Telepítse az Nginxet és a Certbotot a gépen:

sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx

Hozza létre a /etc/nginx/sites-available/dolibarr.conf fájlt a következő tartalommal, az erp.example.com helyére a saját valódi domainjét írva:

server {
    listen 80;
    listen [::]:80;
    server_name erp.example.com;

    client_max_body_size 64M;

    location / {
        proxy_pass http://127.0.0.1:2793;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Port $server_port;
    }
}

Engedélyezze a site-ot, és töltse újra az Nginxet:

sudo ln -s /etc/nginx/sites-available/dolibarr.conf /etc/nginx/sites-enabled/dolibarr.conf
sudo nginx -t
sudo systemctl reload nginx

Igényeljen Let’s Encrypt tanúsítványt:

sudo certbot --nginx -d erp.example.com

A tanúsítvány sikeres kiállítása után a Certbot frissíti az Nginx konfigurációját, hogy engedélyezze a HTTPS-t, és a HTTP-forgalmat HTTPS-re irányítsa át.

3.2.1.6. Váltson át a Dolibarr felhasználóra#

Váltson át az új felhasználóra:

sudo -iu dolibarr

Az oktatóanyag további Podman-parancsait ezzel a felhasználóval kell futtatni, hogy a telepítés rootless maradjon.

3.2.1.7. Hozzon létre állandó könyvtárakat#

Hozza létre az állandó adatokat tároló könyvtárakat:

mkdir -p ~/dolibarr/{mariadb,documents,custom}
cd ~/dolibarr

Mindezt azért kell megtenni, hogy újraindítás esetén, vagy a Dolibarr újabb verzióra történő frissítésekor ne veszítsen adatokat.

3.2.1.8. Hozza létre a környezeti fájlt#

Create a .env file for database and Dolibarr settings:

cat > .env <<'EOF'
MYSQL_ROOT_PASSWORD=CHANGE_THIS_ROOT_PASSWORD
MYSQL_DATABASE=dolidb
MYSQL_USER=dolidbuser
MYSQL_PASSWORD=CHANGE_THIS_DB_PASSWORD

DOLI_INSTALL_AUTO=1
DOLI_INIT_DEMO=0
DOLI_PROD=1
DOLI_DB_HOST=mariadb
DOLI_DB_HOST_PORT=3306
DOLI_DB_NAME=dolidb
DOLI_DB_USER=dolidbuser
DOLI_DB_PASSWORD=CHANGE_THIS_DB_PASSWORD
DOLI_URL_ROOT=https://erp.example.com
DOLI_ADMIN_LOGIN=admin
DOLI_ADMIN_PASSWORD=CHANGE_THIS_ADMIN_PASSWORD

WWW_USER_ID=1000
WWW_GROUP_ID=1000
EOF

Ezek a változók a hivatalos Dolibarr konténerfelület részét képezik. A folytatás előtt mindig ellenőrizze újra, hogy nem változtak-e, és hogy nem vezettek-e be új megkötéseket vagy ajánlásokat.

3.2.1.9. Hozza létre a compose fájlt#

Hozza létre a compose.yml fájlt:

cat > compose.yml <<'EOF'
services:
  mariadb:
    image: docker.io/library/mariadb:latest
    container_name: dolibarr-mariadb
    env_file:
      - .env
    volumes:
      - ./mariadb:/var/lib/mysql:Z
    restart: unless-stopped

  web:
    image: docker.io/dolibarr/dolibarr:latest
    container_name: dolibarr-web
    env_file:
      - .env
    depends_on:
      - mariadb
    ports:
      - "2793:80"
    volumes:
      - ./documents:/var/www/documents:Z
      - ./custom:/var/www/html/custom:Z
    restart: unless-stopped
EOF

3.2.1.10. Indítsa el a Dolibarrt#

Indítsa el a stacket:

podman-compose up -d
podman-compose logs

Ellenőrizze, hogy a konténerek futnak:

podman ps
podman-compose logs

Nyissa meg a böngészőt, és navigáljon a következő címre:

https://erp.example.com

Ha minden megfelelően van beállítva, a Dolibarr webes felületét HTTPS-en keresztül kell látnia.

3.2.1.11. Egyéni modulok telepítése#

Mostantól modulokat helyezhet el a ~/dolibarr/custom könyvtárban. A TalerBarr modul példájához folytassa a Telepítés a forráskód-tárolóból résznél.

A Dolibarr és a Talerbarr telepítése parancssorból

Contents