How to Add a Resource - Cloud Security Office Hours

📖 What You'll Learn

Understanding what you're doing
Finding and preparing your resource
Adding it to the website
Creating a pull request
Getting your resource published

⏱️ Time needed: ~10-15 minutes for your first contribution

            ✨ Good news: You don't need to be a programmer. You just need to find a cool resource, copy
            and paste some text, and follow a few simple steps.
        

Fastest option: Run the interactive script below to add a resource automatically.

python3 tools/submit_resource.py

See the full script guide →

            Common errors (and quick fixes):
            python3 not found: Install Python from python.org and reopen your terminal
git not found: Install Git from git-scm.com
Not in a git repo: Run cd csoh.org before the script
Working directory not clean: Commit or stash changes, then retry
URL flagged as unsafe: Use the official site or GitHub repo URL

        

🎯 What is a Resource?

A resource is anything that helps cloud security professionals learn, practice, or advance their careers. Examples:

🎯 CTF Challenges — Intentionally broken cloud setups you practice hacking
🛠️ Security Tools — Software that scans or protects cloud infrastructure
🎓 Certifications — Official courses that teach cloud security skills
🧪 Hands-On Labs — Interactive exercises where you learn by doing
💼 Job Boards — Places to find cloud security careers
🤖 AI Security Resources — Tools and training for AI/ML security

🚀 Quick Start: Add a Resource in 5 Steps

Gather Your Resource Info

Before you do anything technical, write down these details about your resource:

                    Name: [e.g., "CloudGoat"]
                    URL: [e.g., "https://github.com/RhinoSecurityLabs/cloudgoat"]
                    Description: [1-2 sentences explaining what it is and why it's useful]
                    Tags: [Select from the list below]
                    Category: [Pick one main category]
                

Example:

                    Name: OWASP EKS Goat
                    URL: https://github.com/OWASP/www-project-eks-goat
                    Description: Intentionally vulnerable AWS EKS environment with 20+ attack-defense
                    labs simulating real-world misconfigurations and IAM flaws.
                    Tags: CTF, Labs & Training, AWS, Kubernetes
                    Category: CTF Challenges
                

Pick Your Tags

Tags help people find resources. Pick 2-5 tags from this list:

Resource Types:

CTF Labs & Training Tool Certification Job Search

Cloud Platforms:

AWS Azure GCP Kubernetes Multi-Cloud

Security Focus:

Vulnerability Testing Penetration Testing Cloud Scanning Secrets Management Compliance AI Security IAM DevSecOps

Other:

NEW 2026 Free Paid Open Source

Get a Preview Image (Optional)

Preview images are the small screenshot shown for each resource. They're optional—the site works without them!

Easy option: Just skip this step! The website will automatically generate thumbnails.

Better option: Provide a custom preview image:

Take a screenshot of the resource's homepage
Save it as a JPG file (about 150KB or smaller)
Name it something clear, like: cloudgoat-preview.jpg

Edit the Resources HTML File

Don't be scared! HTML is just text with special labels. Here's what you need to do:

Go to resources.html on GitHub
Find the section for your resource's category
Copy an existing resource card (we'll show you how)
Paste it and change the details

Here's what a resource card looks like:

                    <a href="PASTE_YOUR_URL_HERE" class="card-link" target="_blank" rel="noopener noreferrer">
                    <div class="resource-card">
                    <h3>Your Resource Name</h3>
                    <p>Your description (1-2 sentences)</p>
                    <div class="resource-tags">
                    <span class="tag ctf">CTF</span>
                    <span class="tag">AWS</span>
                    </div>
                    </div>
                    </a>
                

What to change:

PASTE_YOUR_URL_HERE → Your resource's URL
Your Resource Name → The actual name
Your description... → What you wrote in Step 1
The  lines → Your tags

Tag styling: Some tags have special colors:

 = CTF (teal)
 = Tool (purple)
 = Lab/Training (green)
 = AI Security (orange)
 = Certification (blue)
 = Job Search (pink)
 = Regular tag (gray)

                    💡 Don't worry about images yet! The site will handle that automatically. If you
                    want to add a custom preview image, see Step 5.
                

Add a Preview Image (Optional)

If you took a screenshot in Step 3, follow these sub-steps:

5a. Upload Your Image

Go to the img/previews/ folder on GitHub
Click "Add file" → "Upload files"
Drag/drop your screenshot
Write a commit message: "Add preview image for [Resource Name]"
Click "Commit changes"

5b. Edit preview-mapping.json

Open preview-mapping.json
Click the pencil icon to edit
Find this section and add a new line:

                    {
                    "https://your-resource-url.com": "img/previews/your-preview-image.jpg",
                    "https://another-resource.com": "img/previews/another-preview.jpg"
                    }
                

Scroll down and click "Commit changes"

🍴 Creating a Pull Request (GitHub)

                What's a pull request? It's how you ask a project to accept your changes. Think of it
                as raising your hand in class to share something.
            

Beginner-Friendly Method: GitHub's Web Interface

You don't need to install anything or learn command-line. Here's the easiest way:

Step A: Fork the Repository

Go to github.com/CloudSecurityOfficeHours/csoh.org
Click the "Fork" button (top-right corner)
This creates your own copy of the project

Step B: Edit the Files

In your fork, click on resources.html
Click the pencil icon ✏️ to edit
Find where you want to add your resource (scroll to the right category section)
Paste your resource card (see Step 4 above)
Scroll down and click "Commit changes"
Add a message like: "Add [Resource Name] to resources"
Click "Commit changes" again

Repeat for preview-mapping.json if you have a custom preview image.

Step C: Create the Pull Request

Go back to your fork homepage
You'll see a yellow banner saying "This branch is ahead of CloudSecurityOfficeHours:main"
Click the "Contribute" button → "Open pull request"
Add a title: "Add [Resource Name]"
Add a description:

                **Resource:** [Name]
                **URL:** [Link]
                **Category:** [Category]

                This resource teaches [what it teaches]. It would be great
                for people learning about [what topic].
            

Click "Create pull request"

That's it! The maintainers will review your contribution.

❓ Frequently Asked Questions

Q: Do I need to be a developer to contribute?

A: No! This guide is specifically designed for non-technical people. You just need to copy/paste and follow instructions.

Q: What if I make a mistake?

A: No problem! That's why pull requests exist. You can edit your PR before it's merged, and maintainers can help fix issues.

Q: How long until my resource is published?

A: Usually within a few days. Maintainers review every contribution.

Q: Can I add multiple resources at once?

A: Yes! But start with one to get comfortable with the process.

Q: What if the preview image doesn't show?

A: That's okay! The website will auto-generate a thumbnail. You can always improve it later.

Q: What makes a "good" resource?

A: Anything that helps cloud security professionals learn, practice, or advance their careers. Our community votes with their clicks!

💡 Pro Tips

Check if it already exists: Search resources.html to make sure your resource isn't already there
Write clear descriptions: Pretend you're explaining this to a friend who's new to cloud security
Tag appropriately: Pick tags that help people find it (be specific!)
Test your link: Make sure the URL you're adding actually works
Welcome feedback: Maintainers might suggest improvements—that's normal!
Start with one: Add 1-2 resources first. You'll get the hang of it

📞 Need Help?

🎉 Ready to Add Your First Resource?

Start with Step 1 above!

By adding a resource, you're helping grow the cloud security community. Every contribution matters.

CSOH

📚 How to Add a Cloud Security Resource