Deploy with Apache

Host BentoPDF using Apache HTTP Server.

Prerequisites

• Apache 2.4+
• mod_rewrite enabled
• SSL certificate (recommended)

Step 1: Build the Project

git clone https://github.com/alam00000/bentopdf.git
cd bentopdf
npm install
npm run build

Step 2: Copy Files

sudo mkdir -p /var/www/bentopdf
sudo cp -r dist/* /var/www/bentopdf/
sudo chown -R www-data:www-data /var/www/bentopdf

Step 3: Apache Configuration

Create /etc/apache2/sites-available/bentopdf.conf:

<VirtualHost *:80>
    ServerName your-domain.com
    Redirect permanent / https://your-domain.com/
</VirtualHost>

<VirtualHost *:443>
    ServerName your-domain.com
    DocumentRoot /var/www/bentopdf

    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/your-domain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/your-domain.com/privkey.pem

    <Directory /var/www/bentopdf>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    # WASM MIME type
    AddType application/wasm .wasm

    # Compression
    <IfModule mod_deflate.c>
        AddOutputFilterByType DEFLATE text/html text/plain text/css application/javascript application/json application/wasm
    </IfModule>

    # Cache headers
    <IfModule mod_expires.c>
        ExpiresActive On
        ExpiresByType application/javascript "access plus 1 year"
        ExpiresByType text/css "access plus 1 year"
        ExpiresByType application/wasm "access plus 1 year"
        ExpiresByType image/png "access plus 1 year"
        ExpiresByType image/svg+xml "access plus 1 year"
    </IfModule>

    # Security headers
    Header always set X-Frame-Options "SAMEORIGIN"
    Header always set X-Content-Type-Options "nosniff"
</VirtualHost>

Step 4: .htaccess for SPA Routing

Create /var/www/bentopdf/.htaccess:

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
    
    # Don't rewrite files or directories
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    
    # Rewrite everything else to index.html
    RewriteRule ^ index.html [L]
</IfModule>

Step 5: Enable Required Modules

sudo a2enmod rewrite
sudo a2enmod ssl
sudo a2enmod headers
sudo a2enmod expires
sudo a2enmod deflate

Step 6: Enable the Site

sudo a2ensite bentopdf.conf
sudo apache2ctl configtest
sudo systemctl reload apache2

Subdirectory Deployment

To host at /pdf/:

1. Build with base URL:

BASE_URL=/pdf/ npm run build

2. Update .htaccess:

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /pdf/
    
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.html [L]
</IfModule>

Troubleshooting

WASM 404 Errors

Ensure MIME type is configured:

AddType application/wasm .wasm

Rewrite Not Working

Check that mod_rewrite is enabled:

sudo a2enmod rewrite

Permission Denied

sudo chown -R www-data:www-data /var/www/bentopdf
sudo chmod -R 755 /var/www/bentopdf