Skip to content

DEPLOYMENT.md

Latest commit

 

History

History
243 lines (182 loc) · 5.84 KB

DEPLOYMENT.md

File metadata and controls

243 lines (182 loc) · 5.84 KB

🚀 Deployment Guide - Reverse Engineering Academy

This guide covers multiple ways to deploy your Reverse Engineering Academy so people can access it online without downloading anything locally.

🔮 Option 1: Vercel (Recommended)

Why Vercel?

  • ✅ Free for open source projects
  • ✅ Zero configuration for Next.js
  • ✅ Automatic deployments from GitHub
  • ✅ Global CDN for fast loading worldwide
  • ✅ Custom domains support
  • ✅ Built-in analytics and monitoring

Method A: GitHub Integration (Easiest)

  1. Push to GitHub (if you haven't already):

    # Replace with your actual GitHub repository URL
git remote add origin https://github.com/yourusername/reverse-engineering-academy.git
git branch -M main
git push -u origin main

  2. Deploy via Vercel Dashboard:

    • Go to vercel.com
    • Sign up/login with your GitHub account
    • Click "New Project"
    • Import your reverse-engineering-academy repository
    • Click "Deploy" - That's it!

  3. Your site will be live at:

    https://reverse-engineering-academy-yourusername.vercel.app

Method B: Vercel CLI

  1. Install Vercel CLI:

    npm install -g vercel

  2. Login to Vercel:

    vercel login

  3. Deploy from your local directory:

    cd /path/to/reverse-engineering-academy
vercel

  4. Follow the prompts:

    • Link to existing project? No
    • Project name: reverse-engineering-academy
    • Directory: ./ (current directory)
    • Auto-deploy to production? Yes

🌐 Option 2: Netlify

Great alternative with similar features:

  1. Via GitHub:

    • Go to netlify.com
    • "New site from Git" → Connect GitHub
    • Select your repository
    • Build settings:
      • Build command: npm run build
      • Publish directory: .next

  2. Via Netlify CLI:

    npm install -g netlify-cli
netlify login
netlify deploy --prod --dir=.next

☁️ Option 3: Railway

Simple deployment platform:

  1. Go to railway.app
  2. "Deploy from GitHub repo"
  3. Select your repository
  4. Railway auto-detects Next.js and deploys

🐳 Option 4: Docker + Any Cloud Provider

Create Dockerfile

FROM node:18-alpine AS base

# Install dependencies only when needed
FROM base AS deps
WORKDIR /app
COPY package.json package-lock.json* ./
RUN npm ci

# Rebuild the source code only when needed
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build

# Production image, copy all files and run next
FROM base AS runner
WORKDIR /app

ENV NODE_ENV production

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

COPY --from=builder /app/public ./public

# Set the correct permission for prerender cache
RUN mkdir .next
RUN chown nextjs:nodejs .next

# Automatically leverage output traces to reduce image size
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

USER nextjs

EXPOSE 3000

ENV PORT 3000
ENV HOSTNAME "0.0.0.0"

CMD ["node", "server.js"]

Deploy to:

  • DigitalOcean App Platform
  • AWS App Runner
  • Google Cloud Run
  • Heroku

🆓 Option 5: GitHub Pages (Static Export)

If you want completely free static hosting:

  1. Add to next.config.ts:

    const nextConfig = {
  output: 'export',
  trailingSlash: true,
  images: {
    unoptimized: true
  }
}

  2. Build static version:

    npm run build

  3. Deploy to GitHub Pages:

    • Enable GitHub Pages in repository settings
    • Select source: GitHub Actions
    • Use the out folder as your source

🎯 Recommended Setup for Your Academy

For maximum impact, I recommend this setup:

1. Primary Deployment: Vercel

  • Main site: https://reverse-engineering-academy.vercel.app
  • Automatic deployments from GitHub
  • Free SSL certificate
  • Global CDN for fast loading

2. Custom Domain (Optional)

  • Buy domain: reverseacademy.com or cybersec-academy.dev
  • Point to Vercel deployment
  • Professional appearance for sharing

3. Analytics & Monitoring

  • Vercel Analytics (built-in)
  • Google Analytics for detailed insights
  • Uptime monitoring

🚀 Let's Deploy Right Now!

Here's the fastest path to get your academy online:

Step 1: Commit the Vercel config

git add vercel.json DEPLOYMENT.md
git commit -m "Add Vercel deployment configuration"
git push origin main

Step 2: Deploy to Vercel

  1. Go to vercel.com/new
  2. Import your GitHub repository
  3. Click "Deploy"
  4. Done! Your site is live in ~2 minutes

Step 3: Share Your Academy

Your Reverse Engineering Academy will be available at:

https://reverse-engineering-academy-[username].vercel.app

📊 Expected Performance

With Vercel deployment, your academy will have:

  • ⚡ Load time: < 2 seconds worldwide
  • 🌍 Global availability: 99.9% uptime
  • 📱 Mobile optimized: Perfect Lighthouse scores
  • 🔒 Secure: HTTPS by default
  • 🚀 Fast: Built-in CDN and caching

💡 Pro Tips

  1. Custom Domain: Makes it more professional

    • academy.yourname.com
    • cybersec-learn.dev

  2. Social Sharing: Add Open Graph tags for better social media previews

  3. SEO: Your dark theme and educational content will rank well

  4. Community: Enable GitHub Discussions for student questions

🎉 Success Metrics

Once deployed, you can track:

  • Students visiting lessons
  • Popular lesson topics
  • Geographic distribution
  • Time spent learning

Ready to deploy? The fastest option is Vercel with GitHub integration - your academy can be live in under 5 minutes! 🚀