How to add a Docker Standalone Environment

Prerequisites #

• A running Docker engine
• Network connectivity between NiralOS EDGE and the Docker Environment.
• The Docker API (default port 2375) must be reachable.

Step 1: Navigate to the Site #

From the left navigation menu:

1. Expand the Management section.
2. Click Site.

The Site Management page displays all configured sites.

Step 2: Open the Docker Management Page #

Locate the Site where you want to add the Proxmox environment.

1. Click the Action button corresponding to the desired Site.
2. Select Environments.

The Environments page for the selected Site opens.

Step 3: Add a New Environment #

Scroll to the bottom of the Environments page.

Click Add Environment.

The Add Environment wizard appears.

Step 4: Select the Environment Type #

From the available environment types, select:

Docker Standalone

Step 5: Select the Docker Host Operating System #

Choose the operating system on which the Docker Engine is running.

• Windows
• Linux

The remaining configuration options vary depending on the selected operating system.

Windows Docker Engine #

Step 6. Configure the Docker API Proxy #

Docker Desktop for Windows exposes the Docker Remote API only on the localhost interface.

To allow NiralOS EDGE to communicate with Docker Engine, deploy the Docker API Proxy by running the following command on the Windows machine hosting Docker Engine.

docker run -d --name docker-api-proxy -p 2375:2375 alpine/socat TCP-LISTEN:2375,fork,reuseaddr TCP:host.docker.internal:2375

Important

This step is mandatory for Windows Docker environments.

Due to Docker Desktop security policies, the Docker API is only accessible from localhost. The proxy container exposes the Docker API so that NiralOS EDGE can securely communicate with the Docker Engine.

Step 7. Enter Docker Connection Details #

Provide the following information.

Click Scan Environment.

If the connection succeeds, continue.

Step 8. Enter the Environment Name #

Provide a friendly name for the Docker environment.

Examples

• Production Docker
• Development Docker
• Windows Docker Host
• Edge Docker

Step 9. Enable NiralOS EDGE Insights (Optional) #

If infrastructure observability is required, enable NiralOS EDGE Insights.

NiralOS EDGE Insights provides comprehensive visibility into your infrastructure through:

• Real-time metrics
• Telemetry
• Log collection
• Operational analytics
• Resource utilization monitoring
• Performance monitoring
• Infrastructure health insights

If observability is not required, leave this option disabled.

Step 10. Connect the Environment #

Click Connect.

NiralOS EDGE registers the Windows Docker Engine and completes the onboarding process.

Linux Docker Engine #

Step 6. Enter Docker Connection Details #

Provide the following information.

Click Scan Environment.

Step 7. Enter the Environment Name #

Provide a friendly name for the environment.

Examples

• Production Docker
• Development Docker
• Linux Docker Host
• Branch Office Docker

Step 8. Configure TLS (Optional) #

If your Docker Remote API is secured using TLS, enable the TLS option.

Upload the following files.

Note

TLS configuration is supported only for Linux Docker environments. If your Docker Engine is configured without TLS, leave this option disabled.

Step 9. Enable NiralOS EDGE Insights (Optional) #

If infrastructure observability is required, enable NiralOS EDGE Insights.

NiralOS EDGE Insights provides comprehensive visibility into your infrastructure through:

• Real-time metrics
• Telemetry
• Log collection
• Operational analytics
• Resource utilization monitoring
• Performance monitoring
• Infrastructure health insights

If observability is not required, leave this option disabled.

Step 10. Connect the Environment #

Click Connect.

NiralOS EDGE registers the Linux Docker Engine and completes the onboarding process.

If TLS was configured, all communication between NiralOS EDGE and the Docker Engine is secured using the uploaded certificates.