151 lines
3.3 KiB
Markdown
151 lines
3.3 KiB
Markdown
# 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`
|