Add deployment scripts and Easypanel guide

2026-03-03 22:17:09 +07:00
parent 06b81dc99c
commit 4aadcbad34
2 changed files with 253 additions and 0 deletions
--- a/EASYPANEL-SETUP.md
+++ b/EASYPANEL-SETUP.md
@@ -0,0 +1,150 @@
+# Easypanel Deployment Guide - MoreminiMore Website
+
+## Quick Deploy
+
+### Option 1: Run Deploy Script
+```bash
+cd moreminimore-redesign
+./deploy.sh
+```
+
+### Option 2: Manual Deployment
+
+## Step-by-Step Manual Deployment
+
+### Step 1: Login to Easypanel
+
+Navigate to your Easypanel instance and login.
+
+### Step 2: Create Project (if needed)
+
+1. Click **"New Project"**
+2. Enter project name: `moreminimore-website`
+3. Click **"Create Project"**
+
+### Step 3: Add Service
+
+1. Click **"New Service"** in your project
+2. Select **"Git Repository"**
+
+### Step 4: Configure Git Repository
+
+Fill in the following:
+
+| Field | Value |
+|-------|-------|
+| **Name** | `moreminimore-website` |
+| **Repository URL** | `https://git.moreminimore.com/kunthawat/moreminimore-website.git` |
+| **Branch** | `main` |
+| **Username** | (your Gitea username) |
+| **Password/Token** | (your Gitea password or token) |
+
+### Step 5: Configure Docker
+
+| Field | Value |
+|-------|-------|
+| **Dockerfile** | `Dockerfile` (default) |
+| **Port** | `4321` |
+| **Command** | `npx astro preview --host 0.0.0.0 --port 4321` |
+
+### Step 6: Enable Auto-Deploy
+
+1. Go to **Settings** → **Deploy**
+2. Find **"Auto Deploy"** section
+3. Toggle to **Enabled**
+4. Select branch: `main`
+5. Click **"Save"**
+
+### Step 7: Deploy
+
+1. Go to **Deployments** tab
+2. Click **"Deploy Now"** (or wait for auto-deploy on next push)
+3. Watch the build logs
+4. Wait for deployment to complete (~2-3 minutes)
+
+### Step 8: Verify
+
+1. Click the service URL (provided by Easypanel)
+2. Verify homepage loads
+3. Test navigation and all pages
+
+## Environment Variables
+
+No environment variables required (static site).
+
+## SSL/HTTPS
+
+Easypanel automatically provisions SSL certificates. Your site will be available at:
+- `https://your-service.your-project.easypanel.app`
+
+## Custom Domain (Optional)
+
+To use custom domain:
+
+1. Go to **Settings** → **Domains**
+2. Add your domain: `www.moreminimore.com`
+3. Update DNS records as instructed
+4. Wait for SSL certificate (5-10 minutes)
+
+## Troubleshooting
+
+### Build Fails
+
+1. Check **Deployments** → **Build Logs**
+2. Common issues:
+   - Missing dependencies → Check `package.json`
+   - Build errors → Check TypeScript/Astro errors
+   - Docker issues → Check `Dockerfile`
+
+### Site Not Loading
+
+1. Check if container is running (Easypanel dashboard)
+2. Check container logs
+3. Verify port 4321 is exposed
+4. Check firewall/network settings
+
+### Auto-Deploy Not Working
+
+1. Verify auto-deploy is enabled
+2. Check webhook configuration in Gitea
+3. Manual trigger: Click **"Deploy Now"**
+
+## Update Deployment
+
+After initial setup, updates are automatic:
+
+```bash
+# Make changes
+cd moreminimore-redesign
+
+# Commit and push
+git add .
+git commit -m "Update: [description]"
+git push origin main
+
+# Easypanel auto-deploys within 1-2 minutes
+```
+
+## Rollback
+
+To rollback to previous version:
+
+1. Go to **Deployments** tab
+2. Find previous successful deployment
+3. Click **"Redeploy"** on that version
+
+## Monitoring
+
+- **Logs**: Easypanel → Service → Logs
+- **Deployments**: Easypanel → Service → Deployments
+- **Resource Usage**: Easypanel → Service → Metrics
+
+## Support
+
+For Easypanel-specific issues:
+- Documentation: https://easypanel.io/docs
+- Discord: https://discord.gg/9bcDSXcZQ7
+
+For this project:
+- Check `DEPLOYMENT.md`
+- Check `CHECKLIST.md`