astro static deployemnt

Deploying a static Astro site on an EC2 instance with Nginx is simple — no Node server, no PM2, no SSR. Nginx directly serves the files inside the dist/ folder.

Here is the cleanest and correct deployment guide.

---

✅ 1. Build your Astro site locally

On your machine:

npm run build

This creates:

dist/
  index.html
  assets/
  images/
  ...

---

✅ 2. Upload the dist folder to your EC2 instance

From your computer:

rsync -avz dist/ ubuntu@your-ec2-ip:/var/www/mysite

Or via SCP:

scp -r dist ubuntu@your-ec2-ip:/var/www/mysite

This produces:

/var/www/mysite/
    index.html
    assets/

---

✅ 3. Install Nginx (if not already installed)

SSH into EC2:

sudo apt update
sudo apt install nginx -y

Enable and start:

sudo systemctl enable nginx
sudo systemctl start nginx

---

✅ 4. Create an Nginx config for your site

Create:

sudo nano /etc/nginx/sites-available/mysite

Paste the following:

server {
    listen 80;
    server_name your-domain.com;

    root /var/www/mysite;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Save and exit.

---

✅ 5. Enable the site

sudo ln -s /etc/nginx/sites-available/mysite /etc/nginx/sites-enabled/mysite

Remove the default site (optional):

sudo rm /etc/nginx/sites-enabled/default

Test syntax:

sudo nginx -t

Reload:

sudo systemctl reload nginx

---

🌍 Your static Astro site is now live!

Test:

curl http://your-ec2-ip

---

🔐 6. Add HTTPS (recommended)

Install Certbot:

sudo apt install certbot python3-certbot-nginx -y

Run:

sudo certbot --nginx -d your-domain.com

Done — your Astro static site now has HTTPS.

---

📌 Summary

Step	Purpose
Build Astro	npm run build → generates dist/
Upload to EC2	Copy files to /var/www/mysite
Install Nginx	Serve static files
Configure Nginx	Point root to your dist folder
Enable HTTPS	Use Certbot

---

🎁 Optional: want a full deployment script like we did for SSR?

I can generate a complete static deployment script (copy + Nginx + Certbot). Just tell me:

• your domain
• your site folder name (mysite?)
• Ubuntu version (probably 22.04)

I’ll generate it.

Perfect — here is your fully customized static Astro deployment script for:

• Domain: wik1.evolo.fr
• Site folder: /var/www/wik1
• Stack: Ubuntu + Nginx + Certbot
• Deployment type: static Astro (dist/ folder)

Just copy/paste the script into your EC2 instance.

---

🚀 STATIC ASTRO DEPLOYMENT SCRIPT (wik1.evolo.fr)

#!/bin/bash

# ---------------------------------------------------
# CONFIGURATION
# ---------------------------------------------------
DOMAIN="wik1.evolo.fr"
SITE_DIR="/var/www/wik1"

# ---------------------------------------------------
# UPDATE SYSTEM
# ---------------------------------------------------
sudo apt update && sudo apt upgrade -y

# ---------------------------------------------------
# INSTALL NGINX
# ---------------------------------------------------
sudo apt install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx

# ---------------------------------------------------
# CREATE SITE FOLDER
# ---------------------------------------------------
sudo mkdir -p $SITE_DIR
sudo chown -R $USER:$USER $SITE_DIR

echo "⚠️ Now upload your Astro dist/ folder to: $SITE_DIR"
echo "Example:"
echo "rsync -avz dist/ ubuntu@your-ec2-ip:$SITE_DIR"
echo ""

# ---------------------------------------------------
# CREATE NGINX CONFIG
# ---------------------------------------------------
sudo bash -c "cat >/etc/nginx/sites-available/wik1 <<EOF
server {
    listen 80;
    server_name $DOMAIN;

    root $SITE_DIR;
    index index.html;

    location / {
        try_files \$uri \$uri/ =404;
    }
}
EOF"

# ENABLE SITE
sudo ln -sf /etc/nginx/sites-available/wik1 /etc/nginx/sites-enabled/wik1

# REMOVE DEFAULT SITE
sudo rm -f /etc/nginx/sites-enabled/default

# TEST AND RELOAD NGINX
sudo nginx -t && sudo systemctl reload nginx

echo "---------------------------------------------------"
echo "🚀 Static site configured for http://$DOMAIN"
echo "---------------------------------------------------"
echo ""
echo "To enable HTTPS, run the following:"
echo "sudo apt install certbot python3-certbot-nginx -y"
echo "sudo certbot --nginx -d $DOMAIN"

---

📤 After running the script

1️⃣ Upload your Astro dist/ folder to the server:

On your computer:

rsync -avz dist/ ubuntu@YOUR_EC2_IP:/var/www/wik1

Or:

scp -r dist/* ubuntu@YOUR_EC2_IP:/var/www/wik1

---

🔎 2️⃣ Check Nginx is serving the site

curl http://wik1.evolo.fr

You should see your Astro site.

---

🔐 3️⃣ Enable HTTPS (recommended)

On the EC2 instance:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d wik1.evolo.fr

Your site will now be available on https://wik1.evolo.fr.

---

🎉 Done!

If you want, I can also generate:

• A multi-site Nginx config (wik1, test1, api, etc.)
• A zero-downtime deploy script
• A script to auto-sync dist via GitHub Actions

Just tell me!

Here’s exactly where to put the deployment script on your EC2 instance and how to run it.

---

✅ 1. Create the script on your EC2 instance

SSH into your EC2 server:

ssh ubuntu@YOUR_EC2_IP

Create a file, for example:

nano deploy-wik1.sh

Paste the whole script inside.

Save CTRL+O, then exit CTRL+X.

---

✅ 2. Make the script executable

Run:

chmod +x deploy-wik1.sh

This allows Linux to run it as a program.

---

✅ 3. Run the script

Simply run:

./deploy-wik1.sh

or:

bash deploy-wik1.sh

Both work.

---

✅ 4. Upload your Astro dist folder

After the script finishes, upload your local dist/:

rsync -avz dist/ ubuntu@YOUR_EC2_IP:/var/www/wik1

---

📌 You’re done!

Your site becomes available at:

👉 http://wik1.evolo.fr

Then run Certbot if you want HTTPS:

sudo certbot --nginx -d wik1.evolo.fr

---

⚠️ Need me to generate a safer version of the script (with checks, logging, backups)?

Just tell me.