DEV Community

Hedy
Hedy

Posted on

How do you set up a Raspberry Pi as a web server?

#raspberrypi #pi4 #pi5 #webserver

Whether you're hosting a personal website, a blog, or a home automation dashboard, here's how to turn your Raspberry Pi into a fully functional web server using Apache, Nginx, or Lighttpd.

Image description

1. Prerequisites
Hardware:

  • Raspberry Pi (any model, but Pi 4/5 recommended for better performance)
  • MicroSD card (16GB+ recommended)
  • Power supply
  • Ethernet cable (or Wi-Fi connection)

Software:

  • Raspberry Pi OS (previously Raspbian) installed (Download Here)
  • Basic Linux command-line knowledge

2. Initial Setup
Step 1: Install Raspberry Pi OS

  1. Flash Raspberry Pi OS Lite (headless) or Desktop to the SD card using Raspberry Pi Imager.
  2. Enable SSH (for remote access) by creating an empty ssh file in the boot partition.

Step 2: Connect & Update

  1. Power on the Pi and connect via Ethernet/Wi-Fi.
  2. SSH into it (default credentials: pi / raspberry): 
bash

ssh [email protected]
Enter fullscreen mode Exit fullscreen mode
  1. Update the system: 
bash

sudo apt update && sudo apt upgrade -y
Enter fullscreen mode Exit fullscreen mode

3. Install a Web Server
Option A: Apache (Easiest for Beginners)

  1. Install Apache: 
bash

sudo apt install apache2 -y
Enter fullscreen mode Exit fullscreen mode
  1. Test it:

Option B: Nginx (Faster & More Efficient)

  1. Install Nginx: 
bash

sudo apt install nginx -y
Enter fullscreen mode Exit fullscreen mode
  1. Test it:

Visit http://raspberrypi.local → You should see the Nginx welcome page.

Option C: Lighttpd (Lightweight Alternative)

  1. Install Lighttpd: 
bash

sudo apt install lighttpd -y
Enter fullscreen mode Exit fullscreen mode
  1. Enable PHP (if needed): 
bash

sudo apt install php-fpm php-mysql -y
sudo lighty-enable-mod fastcgi-php
sudo systemctl restart lighttpd
Enter fullscreen mode Exit fullscreen mode

4. Host Your Website
Step 1: Upload Website Files
Default web root locations:

  • Apache: /var/www/html/
  • Nginx: /var/www/html/
  • Lighttpd: /var/www/html/

Replace the default index.html with your own files:

bash

sudo rm /var/www/html/index.*
sudo cp ~/my-website/* /var/www/html/
sudo chown -R www-data:www-data /var/www/html/
Enter fullscreen mode Exit fullscreen mode

Step 2: Enable PHP (Optional)
If your site uses PHP:

bash

sudo apt install php php-mysql -y  # For Apache
sudo systemctl restart apache2    # Or nginx/lighttpd
Enter fullscreen mode Exit fullscreen mode

Test with:

bash

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php
Enter fullscreen mode Exit fullscreen mode

Visit http://raspberrypi.local/info.php to verify.

5. Make It Accessible from the Internet
Step 1: Set a Static IP (Recommended)
Edit /etc/dhcpcd.conf:

bash

sudo nano /etc/dhcpcd.conf
Enter fullscreen mode Exit fullscreen mode

Add:

ini

interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=8.8.8.8
Enter fullscreen mode Exit fullscreen mode

Restart networking:

bash

sudo systemctl restart dhcpcd
Enter fullscreen mode Exit fullscreen mode

Step 2: Port Forwarding (If Behind a Router)

  1. Log in to your router (usually 192.168.1.1).
  2. Forward port 80 (HTTP) and 443 (HTTPS) to your Pi’s local IP.

Step 3: Use a Dynamic DNS (If You Don’t Have a Static IP)
Free options: DuckDNS, No-IP.

Install DuckDNS:

bash

sudo apt install duckdns
sudo nano /etc/duckdns/duck.sh  # Add your token
sudo chmod +x /etc/duckdns/duck.sh
sudo crontab -e
Enter fullscreen mode Exit fullscreen mode

Add:

cron

*/5 * * * * /etc/duckdns/duck.sh >/dev/null 2>&1
Enter fullscreen mode Exit fullscreen mode

Step 4: Secure with HTTPS (Let’s Encrypt)

  1. Install Certbot: 
bash

sudo apt install certbot python3-certbot-apache -y  # For Apache
# Or for Nginx: python3-certbot-nginx
Enter fullscreen mode Exit fullscreen mode
  1. Get a free SSL certificate: 
bash

sudo certbot --apache -d yourdomain.duckdns.org
Enter fullscreen mode Exit fullscreen mode
  1. Auto-renewal: 
bash

sudo crontab -e
Enter fullscreen mode Exit fullscreen mode

Add:

cron

0 12 * * * /usr/bin/certbot renew --quiet
Enter fullscreen mode Exit fullscreen mode

6. Optimize Performance
For Raspberry Pi 4/Pi 5
Enable PHP OPcache (if using PHP):

bash

sudo nano /etc/php/8.2/apache2/php.ini
Enter fullscreen mode Exit fullscreen mode

Uncomment:

ini

opcache.enable=1
opcache.enable_cli=1
opcache.memory_consumption=128
Enter fullscreen mode Exit fullscreen mode

Use a Lightweight Database (If Needed)
SQLite (for simple sites):

bash

sudo apt install sqlite3 php-sqlite3 -y
Enter fullscreen mode Exit fullscreen mode

MariaDB (for WordPress, etc.):

bash

sudo apt install mariadb-server php-mysql -y
sudo mysql_secure_installation
Enter fullscreen mode Exit fullscreen mode

7. Monitor Your Server
Check Apache/Nginx logs:

bash

sudo tail -f /var/log/apache2/access.log  # For Apache
sudo tail -f /var/log/nginx/access.log    # For Nginx
Enter fullscreen mode Exit fullscreen mode

Monitor CPU/RAM usage:

bash

htop
Enter fullscreen mode Exit fullscreen mode

8. Next Steps
Host a WordPress site:

bash

sudo apt install wordpress php-gd -y
Enter fullscreen mode Exit fullscreen mode

Set up a VPN (for secure remote access):

bash

sudo apt install wireguard -y
Enter fullscreen mode Exit fullscreen mode

Automate backups:

bash

sudo apt install rsync
rsync -avz /var/www/html/ backup-server:/path/to/backup/
Enter fullscreen mode Exit fullscreen mode

Final Checklist
✅ Web server installed (Apache/Nginx/Lighttpd)
✅ Website files uploaded
✅ Static IP configured
✅ Port forwarding enabled (if needed)
✅ HTTPS secured (Certbot)
✅ Performance optimized

Top comments (0)