update

Author: petercrocker

docs/docs/enterprise.mdx

@@ -0,0 +1,200 @@
+---
+title: Using Infrahub Enterprise
+---
+
+This guide explains how to configure the demo environment to use Infrahub Enterprise edition instead of the Community edition. Enterprise edition provides additional features including increased performance, enhanced security, and enterprise support.
+
+## Understanding the editions
+
+Infrahub is available in two editions:
+
+- **Community edition** - The standard open-source version with core functionality
+- **Enterprise edition** - The commercial version with additional enterprise features
+
+The demo environment supports both editions and can be switched between them using a simple configuration change.
+
+## Configuration
+
+Edition selection is controlled by environment variables in the `.env` file at the root of the demo repository. The key variable is `INFRAHUB_ENTERPRISE`:
+
+```bash
+# Community edition (default)
+export INFRAHUB_ENTERPRISE="false"
+
+# Enterprise edition
+export INFRAHUB_ENTERPRISE="true"
+```
+
+### Environment variables reference
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `INFRAHUB_ENTERPRISE` | `false` | Set to `true` to use Enterprise edition |
+| `INFRAHUB_VERSION` | `stable` | Infrahub version to use (for example, `1.5.0b1`, `stable`, `develop`) |
+| `INFRAHUB_ADDRESS` | `http://localhost:8000` | Infrahub API address |
+| `INFRAHUB_API_TOKEN` | (demo token) | API authentication token |
+
+## Switching to Enterprise edition
+
+To switch from Community to Enterprise edition:
+
+### Step 1: update the configuration
+
+Edit the `.env` file in the root of the demo repository:
+
+```bash
+# Change this line from "false" to "true"
+export INFRAHUB_ENTERPRISE="true"
+```
+
+### Step 2: source the environment file
+
+For the changes to take effect, source the environment file:
+
+```bash
+source .env
+```
+
+### Step 3: verify the configuration
+
+Check that the Enterprise edition will be used:
+
+```bash
+uv run invoke info
+```
+
+You should see output similar to:
+
+```bash
+Infrahub Edition: Enterprise
+Version: 1.5.0b1
+Command: curl -s https://infrahub.opsmill.io/enterprise/1.5.0b1 | ...
+```
+
+### Step 4: restart Infrahub
+
+To apply the change, destroy the existing environment and start fresh:
+
+```bash
+# Stop and remove all containers and volumes
+uv run invoke destroy
+
+# Start with Enterprise edition
+uv run invoke start
+```
+
+:::tip
+The `destroy` command removes all containers and data volumes. If you have data you want to preserve, consider exporting it first using `infrahubctl`.
+:::
+
+### Step 5: reload your data
+
+After switching editions, you'll need to reload your schemas and data:
+
+```bash
+# Load schemas
+uv run infrahubctl schema load schemas
+
+# Load menu definitions
+uv run infrahubctl menu load menu
+
+# Load bootstrap data
+uv run infrahubctl object load objects/bootstrap
+```
+
+Or use the bootstrap script:
+
+```bash
+./scripts/bootstrap.sh
+```
+
+## Switching back to Community edition
+
+To switch from Enterprise back to Community edition, follow the same process but set `INFRAHUB_ENTERPRISE="false"`:
+
+```bash
+# Edit .env and change to "false"
+source .env
+
+# Verify configuration
+uv run invoke info
+
+# Restart
+uv run invoke destroy
+uv run invoke start
+```
+
+## How it works
+
+When you run `uv run invoke start`, the system constructs the appropriate Docker Compose command based on your configuration:
+
+**Community edition URL pattern:**
+
+```bash
+https://infrahub.opsmill.io/{VERSION}
+```
+
+**Enterprise edition URL pattern:**
+
+```bash
+https://infrahub.opsmill.io/enterprise/{VERSION}
+```
+
+The invoke tasks in `tasks.py` automatically detect the `INFRAHUB_ENTERPRISE` setting and use the correct URL to download the appropriate Docker Compose configuration.
+
+## Checking your current edition
+
+At any time, you can check which edition you're configured to use:
+
+```bash
+source .env && uv run invoke info
+```
+
+This displays:
+
+- The edition (Community or Enterprise)
+- The version being used
+- The full Docker Compose command
+
+## Enterprise features
+
+Enterprise edition includes additional capabilities not available in Community edition. For details on specific enterprise features, refer to the [Infrahub documentation](https://docs.infrahub.app).
+
+:::info
+Enterprise edition may require valid licensing credentials or enterprise authentication. Contact OpsMill for enterprise licensing information.
+:::
+
+## Troubleshooting
+
+### Changes not taking effect
+
+If you change the `INFRAHUB_ENTERPRISE` setting but the wrong edition starts:
+
+1. Ensure you sourced the `.env` file: `source .env`
+2. Verify the setting with `uv run invoke info`
+3. Make sure you destroyed the old environment before starting: `uv run invoke destroy`
+
+### Environment file not found
+
+If you get errors about missing environment variables:
+
+1. Ensure the `.env` file exists in the root of the demo repository
+2. Make sure you're running commands from the demo repository root
+3. Source the file explicitly: `source .env`
+
+### Version compatibility
+
+Ensure your `INFRAHUB_VERSION` setting is compatible with Enterprise edition. Some development or beta versions may not have Enterprise builds available.
+
+## Best practices
+
+- **Use explicit versions** - Instead of `stable`, specify exact versions like `1.5.0b1` for reproducible environments
+- **Document your choice** - Note which edition you're using in project documentation
+- **Test on Community first** - Validate your schemas and generators on Community edition before deploying to Enterprise
+- **Keep configurations in sync** - If working in a team, ensure everyone uses the same edition for consistency
+
+## Additional resources
+
+- [Infrahub documentation](https://docs.infrahub.app)
+- [OpsMill website](https://opsmill.com)
+- [Enterprise edition details](https://opsmill.com/pricing)

docs/docs/readme.mdx

@@ -31,6 +31,7 @@ This documentation is organized following the [Diataxis framework](https://diata
 | Page | Purpose |
 |------|---------|
 | **[Developer guide](./developer-guide.mdx)** | Technical deep-dive into how the demo works under the hood. Covers schema architecture, bootstrap scripts, generators, transforms, checks, and testing. Use this when extending functionality, troubleshooting issues, or understanding implementation details. |
+| **[Using Infrahub Enterprise](./enterprise.mdx)** | Instructions for configuring the demo environment to use Infrahub Enterprise edition. Learn how to switch between Community and Enterprise editions, configure environment variables, and understand the differences between editions. |
 
 ### Topics
 

docs/sidebars.ts

@@ -22,6 +22,7 @@ const sidebars: SidebarsConfig = {
       label: 'Guides',
       items: [
         'developer-guide',
+        'enterprise',
       ],
     },
     {

scripts/bootstrap.sh

@@ -16,8 +16,8 @@ uv run infrahubctl object load objects/security/ --branch $BRANCH
 echo "Add demo repository"
 uv run infrahubctl repository add DEMO https://github.com/opsmill/infrahub-demo.git --ref main --read-only
 
-echo "Wait for repo sync - let's sleep for 90 seconds"
-sleep 90
+echo "Wait for repo sync - let's sleep for 120 seconds"
+sleep 120
 
 echo "Add event actions"
 uv run infrahubctl object load objects/events/ --branch $BRANCH

tasks.py

@@ -7,24 +7,42 @@
 
 
 INFRAHUB_VERSION = os.getenv("INFRAHUB_VERSION", "stable")
+INFRAHUB_ENTERPRISE = os.getenv("INFRAHUB_ENTERPRISE", "false").lower() == "true"
 MAIN_DIRECTORY_PATH = Path(__file__).parent
 
 # Download compose file and use with override
 def get_compose_command() -> str:
     """Generate docker compose command with override support."""
+    # Determine the base URL based on edition
+    if INFRAHUB_ENTERPRISE:
+        base_url = f"https://infrahub.opsmill.io/enterprise/{INFRAHUB_VERSION}"
+    else:
+        base_url = f"https://infrahub.opsmill.io/{INFRAHUB_VERSION}"
+
     override_file = MAIN_DIRECTORY_PATH / "docker-compose.override.yml"
     if override_file.exists():
-        return f"curl -s https://infrahub.opsmill.io/{INFRAHUB_VERSION} | docker compose -p infrahub -f - -f {override_file}"
-    return f"curl -s https://infrahub.opsmill.io/{INFRAHUB_VERSION} | docker compose -p infrahub -f -"
+        return f"curl -s {base_url} | docker compose -p infrahub -f - -f {override_file}"
+    return f"curl -s {base_url} | docker compose -p infrahub -f -"
 
 COMPOSE_COMMAND = get_compose_command()
 CURRENT_DIRECTORY = Path(__file__).resolve()
 DOCUMENTATION_DIRECTORY = CURRENT_DIRECTORY.parent / "docs"
 
 
+@task
+def info(context: Context) -> None:
+    """Show current Infrahub configuration."""
+    edition = "Enterprise" if INFRAHUB_ENTERPRISE else "Community"
+    print(f"Infrahub Edition: {edition}")
+    print(f"Version: {INFRAHUB_VERSION}")
+    print(f"Command: {COMPOSE_COMMAND}")
+
+
 @task
 def start(context: Context) -> None:
     """Start all containers."""
+    edition = "Enterprise" if INFRAHUB_ENTERPRISE else "Community"
+    print(f"Starting Infrahub {edition} ({INFRAHUB_VERSION})...")
     context.run(f"{COMPOSE_COMMAND} up -d")