Skip to content

feat: Add comprehensive Cumulus machine setup guide

Mats Lock requested to merge cumulus into main

📋 Summary

This MR adds a complete step-by-step guide for setting up and configuring Cumulus machines for course 1DV026. The guide covers everything from initial SSH connection to deploying production-ready web applications.

🎯 What's Added

  • Complete Cumulus setup guide (your-first-cumulus-machine.md)
  • SSH key setup and connection instructions
  • nginx web server installation and configuration
  • HTTPS/TLS certificate setup with LNU FTK Campus CA
  • Static website creation and deployment
  • Express 5 application development and deployment
  • PM2 process manager configuration
  • Comprehensive troubleshooting section

🔧 Technical Coverage

Infrastructure & Security:

  • SSH key management and secure connections
  • nginx web server with HTTPS encryption
  • SSL/TLS certificates via Certbot and LNU CA
  • Security hardening (server tokens, etc.)

Application Development:

  • Node.js and npm installation
  • Express 5 application deployment
  • Reverse proxy configuration
  • Modular nginx configuration approach

Process Management:

  • PM2 ecosystem configuration
  • Automatic crash recovery
  • Boot persistence setup
  • Application monitoring and logging

🎓 Learning Outcomes

Students will master:

  • ✅ Linux system administration basics
  • ✅ Web server configuration and management
  • ✅ SSL/TLS certificate handling
  • ✅ Modern Node.js application deployment
  • ✅ Production-ready process management
  • ✅ Troubleshooting common server issues

📚 Guide Structure

  1. Prerequisites - SSH setup and verification
  2. Server Setup - Package updates and core installations
  3. Web Server - nginx installation and basic configuration
  4. Security - HTTPS setup and hardening
  5. Development - Static and dynamic application deployment
  6. Production - Process management and monitoring
  7. Troubleshooting - Common issues and solutions

✅ Quality Assurance

  • Step-by-step instructions tested on the Cumulus environment
  • Consistent command formatting and examples
  • Comprehensive error handling and troubleshooting
  • Modular configuration approach for scalability
  • Production-ready security practices

This guide provides students with hands-on experience in real-world server administration and web application deployment.

Merge request reports