{"id":47951151,"url":"https://github.com/xcomponent/appcontrol-release","last_synced_at":"2026-05-11T14:06:29.974Z","repository":{"id":349101353,"uuid":"1200499352","full_name":"xcomponent/appcontrol-release","owner":"xcomponent","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-04T07:58:51.000Z","size":143,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T09:08:58.321Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xcomponent.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-03T13:40:14.000Z","updated_at":"2026-04-03T17:59:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xcomponent/appcontrol-release","commit_stats":null,"previous_names":["xcomponent/appcontrol-release"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/xcomponent/appcontrol-release","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcomponent%2Fappcontrol-release","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcomponent%2Fappcontrol-release/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcomponent%2Fappcontrol-release/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcomponent%2Fappcontrol-release/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xcomponent","download_url":"https://codeload.github.com/xcomponent/appcontrol-release/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xcomponent%2Fappcontrol-release/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31487543,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-04T09:03:16.241Z","updated_at":"2026-04-06T20:04:24.645Z","avatar_url":"https://github.com/xcomponent.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AppControl\n\n[![Release](https://img.shields.io/github/v/release/xcomponent/appcontrol-release?display_name=tag\u0026sort=semver)](https://github.com/xcomponent/appcontrol-release/releases/latest)\n\n**Operational mastery and IT system resilience.** AppControl maps your applications as dependency graphs (DAGs), monitors component health via distributed agents, orchestrates sequenced start/stop/restart operations, manages DR site failover, and provides full DORA-compliant audit trails.\n\n\u003e AppControl is **not** a scheduler. It integrates with existing schedulers (Control-M, AutoSys, Dollar Universe, TWS) via REST API and CLI.\n\n---\n\n## Key Features\n\n| Feature | Description |\n|---------|-------------|\n| **Dependency Maps** | Model applications as DAGs with strong/weak dependencies, visualized in React Flow |\n| **Sequenced Operations** | Start, stop, restart in correct DAG order with parallel execution within levels |\n| **3-Level Diagnostics** | Health (process alive?), Integrity (data consistent?), Infrastructure (OS/prereqs OK?) |\n| **Error Branch Restart** | Detect failed subgraph, restart only affected components |\n| **DR Switchover** | 6-phase site failover with rollback at any phase |\n| **RBAC** | 5 permission levels (view \u003c operate \u003c edit \u003c manage \u003c owner), teams, share links |\n| **Audit Trail** | DORA-compliant append-only logs for every action, state transition, and config change |\n| **Scheduler Integration** | REST API + `appctl` CLI for Control-M, AutoSys, TWS, Dollar Universe |\n| **Distributed Agents** | Rust agents with process detachment (survives agent crash), offline buffering, mTLS |\n| **Realtime UI** | React SPA with WebSocket live updates, weather-style dashboards |\n\n## Architecture\n\n```\n┌──────────────────────────────────────────────────────────────────────┐\n│                         Frontend (React 18)                         │\n│             TypeScript · Vite · Tailwind · shadcn/ui                │\n│                     React Flow · React Query                        │\n└──────────────────────┬───────────────────────┬───────────────────────┘\n                  REST │                   WS  │\n┌──────────────────────▼───────────────────────▼───────────────────────┐\n│                       Backend (Rust + Axum)                          │\n│       FSM Engine · DAG Sequencer · RBAC · Switchover · Reports      │\n├──────────────────┬───────────────────────────────────────────────────┤\n│  PostgreSQL 16   │  or SQLite (standalone)     JWT RS256 Auth        │\n└──────────────────┘                             └─────────────────────┘\n                                  │\n┌─────────────────────────────────▼────────────────────────────────────┐\n│                      Gateway (Rust + Axum)                           │\n│                 WebSocket relay · mTLS · Routing                     │\n└───────────────────┬──────────────────────┬───────────────────────────┘\n                    │                      │\n         ┌──────────▼──────────┐ ┌─────────▼──────────┐\n         │   Agent (Rust)      │ │   Agent (Rust)      │\n         │ Health checks       │ │ Health checks       │\n         │ Process detachment  │ │ Process detachment  │\n         │ Offline buffer      │ │ Offline buffer      │\n         └─────────────────────┘ └─────────────────────┘\n```\n\n---\n\n## Quick Start\n\n### Option 1 — Docker Compose (Linux/macOS)\n\n```bash\n# Download the compose file\ngh release download --repo xcomponent/appcontrol-release --pattern 'docker-compose.release.yaml'\n\n# Start the full stack\nAPPCONTROL_VERSION=1.4.2 docker compose -f docker-compose.release.yaml up -d\n\n# Verify\ncurl http://localhost:3000/health   # → {\"status\":\"ok\"}\n\n# Open the UI\nopen http://localhost:8080\n```\n\n**Login:** `admin@localhost` / `admin`\n\n### Option 2 — Standalone (Windows/Linux, no Docker)\n\nNo database to install, no Docker required. One script does everything.\n\n```powershell\nmkdir AppControl; cd AppControl\n\n# Download the standalone script (visible at the repo root)\nInvoke-WebRequest -Uri \"https://github.com/xcomponent/appcontrol-release/raw/main/appcontrol.ps1\" -OutFile appcontrol.ps1\n\n# Install (downloads binaries + frontend)\n.\\appcontrol.ps1 install\n\n# Start the backend\n.\\appcontrol.ps1 start\n\n# Add your first site (creates gateway + agent, handles enrollment)\n.\\appcontrol.ps1 add-site Production\n\n# Add more sites\n.\\appcontrol.ps1 add-site DR-Site\n```\n\n**Login:** `admin@localhost` / `admin`  \n**Web UI:** http://localhost:3000\n\nOther commands: `stop`, `status`, `upgrade`, `logs [file]`, `help`\n\n\u003e Works on Windows PowerShell 5.1+ and PowerShell Core 6+ (Linux/macOS).\n\n### Option 3 — CLI only\n\n```bash\n# Linux (amd64)\ngh release download --repo xcomponent/appcontrol-release --pattern 'appctl-linux-amd64' --dir /usr/local/bin\nchmod +x /usr/local/bin/appctl-linux-amd64 \u0026\u0026 mv /usr/local/bin/appctl-linux-amd64 /usr/local/bin/appctl\n\n# macOS (Apple Silicon)\ngh release download --repo xcomponent/appcontrol-release --pattern 'appctl-darwin-arm64' --dir /usr/local/bin\nchmod +x /usr/local/bin/appctl-darwin-arm64 \u0026\u0026 mv /usr/local/bin/appctl-darwin-arm64 /usr/local/bin/appctl\n\n# Windows\ngh release download --repo xcomponent/appcontrol-release --pattern 'appctl-windows-amd64.exe' --dir $env:LOCALAPPDATA\\appcontrol\n```\n\n```bash\nexport APPCONTROL_URL=http://localhost:3000\n\nappctl login --email admin@localhost --password admin\nappctl start my-app --wait --timeout 120\nappctl status my-app --format table\nappctl diagnose my-app --level 2\nappctl switchover my-app --target-site lyon --mode FULL --wait\n```\n\n---\n\n## Docker Images\n\nAll images are available on GitHub Container Registry:\n\n```bash\ndocker pull ghcr.io/xcomponent/appcontrol-backend:latest\ndocker pull ghcr.io/xcomponent/appcontrol-frontend:latest\ndocker pull ghcr.io/xcomponent/appcontrol-gateway:latest\ndocker pull ghcr.io/xcomponent/appcontrol-agent:latest\ndocker pull ghcr.io/xcomponent/appcontrol-init-certs:latest\n```\n\n## Release Assets\n\nEach release includes:\n\n| Asset | Description |\n|-------|-------------|\n| `appctl-{os}-{arch}[.exe]` | CLI binary (Linux, macOS, Windows) |\n| `appcontrol-agent-{os}-{arch}[.exe]` | Agent binary |\n| `appcontrol-backend-{os}-{arch}[.exe]` | Backend API server (PostgreSQL) |\n| `appcontrol-backend-sqlite-{os}-{arch}[.exe]` | Backend API server (SQLite standalone) |\n| `appcontrol-gateway-{os}-{arch}[.exe]` | Gateway binary |\n| `appcontrol.ps1` | Standalone deployment script (Windows PS 5.1+ / Linux pwsh) |\n| `docker-compose.release.yaml` | Docker Compose for the full stack |\n| `appcontrol-docs-scripts.zip` | Documentation, scripts, and examples |\n| `appcontrol-*.tgz` | Helm chart (OpenShift compatible) |\n| `checksums-sha256.txt` | SHA-256 checksums |\n\n## Example Maps\n\nReady-to-import application maps in the docs zip:\n\n| Example | Components | Highlights |\n|---------|:----------:|------------|\n| Three-Tier Web App | 7 | Strong/weak deps, DB replication, batch processing |\n| Microservices E-Commerce | 12 | API gateway, message broker, service-per-DB pattern |\n| Core Banking System | 9 | DR switchover, Control-M integration, DORA compliance |\n\n## Documentation\n\nFull documentation is included in `appcontrol-docs-scripts.zip`:\n\n- **[QUICKSTART.md](docs/QUICKSTART.md)** — Getting started guide\n- **[USER_GUIDE.md](docs/USER_GUIDE.md)** — Complete user guide with screenshots\n- **[WINDOWS_DEPLOYMENT.md](docs/WINDOWS_DEPLOYMENT.md)** — Windows deployment guide\n- **[AGENT_INSTALLATION.md](docs/AGENT_INSTALLATION.md)** — Agent installation on all platforms\n- **[CONFIGURATION.md](docs/CONFIGURATION.md)** — All configuration options\n- **[AZURE_GATEWAY.md](docs/AZURE_GATEWAY.md)** — Azure gateway deployment\n- **[PRODUCTION_DEPLOYMENT.md](docs/PRODUCTION_DEPLOYMENT.md)** — Production hardening guide\n\n## Scripts\n\n| Script | Description |\n|--------|-------------|\n| **`appcontrol.ps1`** | **Unified standalone deployment** (install, start, stop, add-site, upgrade) |\n| `scripts/deploy-windows.ps1` | Deploy Windows services (PostgreSQL mode) |\n| `scripts/install-agent-windows.ps1` | Install agent as Windows service |\n| `scripts/deploy-azure-gateway.sh` | Deploy gateway on Azure |\n\n---\n\n## License\n\nCopyright (c) 2024-2026 XComponent SAS. All rights reserved.\n\nThis software is provided as pre-compiled binaries for evaluation and production use.\nRedistribution, reverse engineering, and offering as a managed service are prohibited\nwithout a commercial license.\n\nContact: support@xcomponent.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxcomponent%2Fappcontrol-release","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxcomponent%2Fappcontrol-release","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxcomponent%2Fappcontrol-release/lists"}