open-how2 – Entdecke. Verstehe. Nutze.
Veröffentlicht am
• How2-Host

Laravel auf Debian 12 (Minimalinstallation) einrichten – Schritt für Schritt

Autor
Laravel auf Debian 12 (Minimalinstallation) einrichten – Schritt für Schritt

Ziel

Du möchtest ein Laravel-Projekt lokal oder auf einem Root-Server mit Debian 12 (Bookworm) einrichten – also ohne Control Panel, ohne Docker, ohne Apache (optional), sondern mit allem, was Laravel braucht.

Voraussetzungen

  • Debian 12 minimal installiert
  • root oder sudo-fähiger Benutzer
  • Internetverbindung
  • Domain oder IP zum späteren Aufruf (optional)

Benötigte Komponenten

Ein Laravel-Projekt benötigt:

Komponente Zweck
PHP ≥ 8.2 Ausführung der Laravel-Anwendung
Composer PHP-Dependency-Management
Webserver z. B. Nginx oder Apache
Datenbank z. B. MySQL/MariaDB/PostgreSQL
Node.js Für Assets (z. B. Vite, Tailwind)
npm / yarn Für JS-Dependencies

1. System aktualisieren

sudo apt update && sudo apt upgrade -y

2. PHP 8.2 (oder höher) installieren

sudo apt install -y php php-cli php-common php-mbstring php-xml php-curl php-bcmath php-mysql php-zip php-gd unzip curl git

Optional: php-pgsql für PostgreSQL, php-sqlite3 für SQLite

Prüfen:

php -v

3. Composer installieren

cd ~
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version

4. Webserver installieren (z. B. Nginx)

sudo apt install nginx -y

Alternativ: sudo apt install apache2 libapache2-mod-php

5. Datenbank installieren

MySQL/MariaDB:

sudo apt install mariadb-server -y
sudo mysql_secure_installation

Datenbank und Benutzer anlegen (optional):

sudo mysql -u root -p

CREATE DATABASE laravel_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'secure_pass';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

6. Node.js + npm installieren (für Frontend & Vite)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

Optional: yarn

npm install -g yarn

7. Laravel-Projekt initialisieren

cd /var/www
sudo composer create-project laravel/laravel myapp
cd myapp

Rechte setzen:

sudo chown -R www-data:www-data .
sudo chmod -R 775 storage bootstrap/cache

8. .env-Datei konfigurieren

cp .env.example .env
php artisan key:generate

Bearbeite .env mit Editor deiner Wahl:

nano .env

Datenbankdaten eintragen:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=secure_pass

9. Nginx konfigurieren

Beispiel-Konfiguration für /etc/nginx/sites-available/laravel:

server {
    listen 80;
    server_name yourdomain.com;

    root /var/www/myapp/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

Aktivieren und testen:

sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

10. PHP-FPM sicherstellen

sudo systemctl enable php8.2-fpm
sudo systemctl start php8.2-fpm

11. App testen

Rufe auf:

Bonus: Laravel Frontend-Assets

npm install
npm run dev   # für Entwicklung
npm run build # für Produktion

Fazit

Mit dieser Anleitung hast du Laravel auf einem Debian-12-Server vollständig manuell installiert, inklusive PHP, Composer, Webserver, Datenbank und Node.js. Ideal für produktive Server, die ohne Docker oder Control Panels betrieben werden sollen.

Laravel läuft hervorragend auf Debian – mit etwas Vorbereitung ein hochperformantes Setup.

Ähnliche Beiträge