3.2.1. Instalace Dolibarr a Talerbarr z příkazové řádky#

Důležité: Toto není oficiální návod na instalaci Dolibarr. Jde pouze o kompletního průvodce instalací modulu Talerbarr, konkrétně pomocí instalace založené na složkách, nikoli instalace přes uživatelské rozhraní Dolibarr nebo Dolistore.

Tento návod je určen uživatelům se základními vývojářskými nebo administrátorskými znalostmi. Pokud jste dosud nikdy nepoužívali nástroje příkazové řádky, zvažte uživatelsky přívětivější způsob získání Dolibarr, například řešení SaaS schválené týmem Dolibarr.

3.2.1.1. Mějte Debian server#

Než budete pokračovat, ujistěte se, že máte funkční server Debian s přístupem sudo. Při této instalaci poběží Dolibarr v rootless Podman jako běžný uživatel, zatímco sudo se používá pouze pro instalaci balíčků a počáteční nastavení systému. Rootless Podman je oficiálně podporovaný režim a pro uživatelské služby, které musí přežít odhlášení a spustit se při startu systému, doporučuje dokumentace Podman/systemd povolit pro daného uživatele tzv. „lingering“.

3.2.1.2. Konfigurace záznamu DNS#

Vytvořte záznam DNS u registrátora domény nebo poskytovatele DNS:

Typ: A

Název: erp, dolibarr, nebo jiná subdoména dle vašeho výběru

Hodnota: IP adresa vašeho serveru

3.2.1.3. Instalace Podman#

Nainstalujte Podman a nástroje potřebné pro rootless kontejnery:

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. Vytvořte vyhrazeného uživatele pro Dolibarr#

Vytvořte vyhrazeného neprivilegovaného uživatele, který bude vlastnit a provozovat zásobník Dolibarr:

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

Příkaz loginctl enable-linger je důležitý, protože uživatelské služby systemd by jinak byly po ukončení poslední relace daného uživatele zastaveny.

3.2.1.5. Vytvořte reverzní proxy#

Samozřejmě si jej můžete nastavit způsobem, který preferujete – většinou zde neexistuje jednoznačně správný nebo špatný postup. Zde je pouze popsáno, jak jsme systém připravili my, abychom mohli dokončit text a obrázky tohoto návodu.

Nainstalujte na hostitele Nginx a Certbot:

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

Vytvořte soubor /etc/nginx/sites-available/dolibarr.conf s následujícím obsahem, přičemž erp.example.com nahraďte svou skutečnou doménou:

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;
    }
}

Povolte web a znovu načtěte Nginx:

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

Vyžádejte si certifikát Let’s Encrypt:

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

Po úspěšném vydání certifikátu Certbot upraví konfiguraci Nginx tak, aby povolil HTTPS a přesměroval provoz HTTP na HTTPS.

3.2.1.6. Přepněte se na uživatele Dolibarr#

Přepněte se na nového uživatele:

sudo -iu dolibarr

Všechny zbývající příkazy Podman v tomto návodu by měly být spouštěny pod tímto uživatelem, aby nasazení zůstalo rootless.

3.2.1.7. Vytvořte trvalé adresáře#

Vytvořte adresáře, které budou uchovávat trvalá data:

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

To vše je potřeba udělat proto, abyste nepřišli o data v případě restartu nebo v případě upgradu Dolibarr na novější verzi.

3.2.1.8. Vytvořte soubor s proměnnými prostředí#

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

Tyto proměnné jsou součástí oficiálního rozhraní kontejneru Dolibarr. Před dalším postupem si vždy znovu ověřte, že se nezměnily a že nebyla zavedena žádná nová omezení či doporučení.

3.2.1.9. Vytvořte soubor compose#

Vytvořte compose.yml:

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. Spusťte Dolibarr#

Spusťte zásobník:

podman-compose up -d
podman-compose logs

Ověřte, že kontejnery běží:

podman ps
podman-compose logs

Otevřete prohlížeč a přejděte na:

https://erp.example.com

Pokud je vše správně nakonfigurováno, měli byste vidět webové rozhraní Dolibarr přes HTTPS.

3.2.1.11. Instalace vlastních modulů#

Nyní můžete umístit moduly do adresáře ~/dolibarr/custom. Příklad instalace modulu TalerBarr najdete v části Instalace ze zdrojového repozitáře.

Instalace Dolibarr a Talerbarr z příkazové řádky

Obsah