Netalertx Idempotent Setup

DevOps & Security

netalertx-idempotent-setup

Netalertx Idempotent Setup is an Agent Skill for devops & security published in the netalertx/NetAlertX repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Reprovision and reset the devcontainer environment. Use this when asked to re-run startup, reprovision, setup devcontainer, fix permissions, or reset runtime state.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/netalertx/NetAlertX/blob/HEAD/.github/skills/devcontainer-setup/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/netalertx-idempotent-setup, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Devcontainer Setup

The setup script forcefully resets all runtime state. It is idempotent—every run wipes and recreates all relevant folders, symlinks, and files.

Command

/workspaces/NetAlertX/.devcontainer/scripts/setup.sh

What It Does

Kills all services (php-fpm, nginx, crond, python3)
Mounts tmpfs ramdisks for /tmp/log, /tmp/api, /tmp/run, /tmp/nginx
Creates critical subdirectories
Links /entrypoint.d and /app symlinks
Creates /data, /data/config, /data/db directories
Creates all log files
Runs /entrypoint.sh to start services
Writes version to .VERSION

When to Use

After modifying setup scripts
After container rebuild
When environment is in broken state
After database reset

Philosophy

No conditional logic. Everything is recreated unconditionally. If something doesn't work, run setup again.