eddie/SGO
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
SGO/wiki
History
Eduardo Figueroa a6b2cea31f
Some checks failed
CI / syntax-check (push) Has been cancelled
Details
CI / security-scan (push) Has been cancelled
Details
CI / container-lint (push) Has been cancelled
Details
CI / container-build (push) Has been cancelled
Details
Publish / publish (push) Has been cancelled
Details
Migrate to Podman, Forgejo Actions; clean up cruft 
Container:
- Dockerfile → Containerfile; drop gosu, entrypoint, PUID/PGID user-switching
- HOME=/config so Path.home()/.aws resolves to runtime-mounted credentials
- docker-compose.yml → compose.yml with userns_mode: keep-id for Podman rootless
- .dockerignore → .containerignore
- boto3 unpinned from 1.34.0 to >=1.34.0

CI:
- Remove Woodpecker (.woodpecker.yml, .woodpecker/)
- Add Forgejo Actions (.forgejo/workflows/ci.yml, publish.yml)
- CI: syntax check, security scan, container lint (hadolint), build test
- Publish: build and push to Quay.io on main push and version tags

Cleanup:
- Remove entrypoint.sh (no longer needed)
- Remove scripts/build-and-push.sh and PUBLISHING.md (superseded by CI)
- All docker → podman command references updated

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-16 15:41:08 -07:00
..
_Sidebar.md wiki 2025-11-20 14:41:17 -08:00
AWS-Configuration.md wiki 2025-11-20 14:41:17 -08:00
Building-and-Publishing.md Migrate to Podman, Forgejo Actions; clean up cruft 2026-03-16 15:41:08 -07:00
Configuration.md wiki 2025-11-20 14:41:17 -08:00
FAQ.md wiki 2025-11-20 14:41:17 -08:00
Home.md wiki 2025-11-20 14:41:17 -08:00
Quick-Start.md wiki 2025-11-20 14:41:17 -08:00
README.md wiki 2025-11-20 14:41:17 -08:00
Troubleshooting.md wiki 2025-11-20 14:41:17 -08:00
Usage.md wiki 2025-11-20 14:41:17 -08:00

README.md

SGO Wiki

This directory contains comprehensive documentation for SGO (Security Groups Observatory).

Wiki Pages

Getting Started

  • Home - Project overview, features, and file structure
  • Quick Start - Get up and running in 30 seconds

Configuration

  • Configuration - Environment variables, data storage options, and configuration examples
  • AWS Configuration - AWS profile setup, MFA configuration, and IAM permissions

Usage

  • Usage Guide - Complete guide to using SGO features including search, views, and CSV exports
  • FAQ - Frequently asked questions

Help

Using These Docs

For New Users

  1. Start with Quick Start to get SGO running
  2. Read AWS Configuration to set up your AWS profiles
  3. Check Usage Guide to learn the features

For Troubleshooting

  1. Check FAQ for common questions
  2. Review Troubleshooting for specific error messages
  3. If still stuck, open an issue with logs and details

For Configuration

  1. See Configuration for all environment variables
  2. Review configuration examples for your use case
  3. Check platform-specific notes if on Windows/macOS/Linux

Contributing to Documentation

Found an error or want to improve the docs?

  1. Edit the relevant markdown file
  2. Submit a pull request
  3. Follow the contribution guidelines in CONTRIBUTING.md

Publishing to Wiki

These markdown files can be:

  • Used directly in the repository
  • Published to GitHub/Codeberg wiki pages
  • Rendered with any markdown viewer
  • Hosted on documentation platforms

For Codeberg, these files can be copied to the repository's wiki section.