generated from theradcoza/Laravel-Docker-Dev-Template
93 lines
1.9 KiB
Markdown
93 lines
1.9 KiB
Markdown
# Apache Virtual Host Setup for Laravel
|
|
|
|
## Prerequisites
|
|
|
|
Ubuntu 24.04 with Apache2 and PHP-FPM installed.
|
|
|
|
## Required Apache Modules
|
|
|
|
Enable the necessary modules:
|
|
|
|
```bash
|
|
sudo a2enmod rewrite
|
|
sudo a2enmod headers
|
|
sudo a2enmod ssl
|
|
sudo a2enmod proxy_fcgi
|
|
sudo a2enmod deflate
|
|
sudo a2enmod expires
|
|
sudo a2enmod setenvif
|
|
```
|
|
|
|
## Installation Steps
|
|
|
|
### 1. Copy Virtual Host Configuration
|
|
|
|
```bash
|
|
sudo cp deploy/apache/laravel-site.conf /etc/apache2/sites-available/your-app.conf
|
|
```
|
|
|
|
### 2. Edit Configuration
|
|
|
|
Update the following in the config file:
|
|
- `ServerName` - Your domain name
|
|
- `DocumentRoot` - Path to Laravel's public folder
|
|
- `Directory` - Same path as DocumentRoot
|
|
- Log file names
|
|
|
|
### 3. Enable Site
|
|
|
|
```bash
|
|
sudo a2ensite your-app.conf
|
|
sudo a2dissite 000-default.conf # Disable default site if needed
|
|
```
|
|
|
|
### 4. Test Configuration
|
|
|
|
```bash
|
|
sudo apache2ctl configtest
|
|
```
|
|
|
|
### 5. Restart Apache
|
|
|
|
```bash
|
|
sudo systemctl restart apache2
|
|
```
|
|
|
|
## SSL with Certbot
|
|
|
|
Install Certbot and obtain SSL certificate:
|
|
|
|
```bash
|
|
sudo apt install certbot python3-certbot-apache
|
|
sudo certbot --apache -d your-domain.com -d www.your-domain.com
|
|
```
|
|
|
|
Certbot will automatically modify your Apache configuration for SSL.
|
|
|
|
## File Permissions
|
|
|
|
Set correct permissions for Laravel:
|
|
|
|
```bash
|
|
sudo chown -R www-data:www-data /var/www/your-app
|
|
sudo chmod -R 755 /var/www/your-app
|
|
sudo chmod -R 775 /var/www/your-app/storage
|
|
sudo chmod -R 775 /var/www/your-app/bootstrap/cache
|
|
```
|
|
|
|
## Common Issues
|
|
|
|
### 403 Forbidden
|
|
- Check directory permissions
|
|
- Ensure `AllowOverride All` is set
|
|
- Verify `mod_rewrite` is enabled
|
|
|
|
### 500 Internal Server Error
|
|
- Check Laravel logs: `storage/logs/laravel.log`
|
|
- Check Apache error logs: `/var/log/apache2/your-app-error.log`
|
|
- Ensure `.env` file exists and has correct permissions
|
|
|
|
### PHP Not Processing
|
|
- Verify PHP-FPM is running: `sudo systemctl status php8.3-fpm`
|
|
- Check socket path matches in Apache config
|