Deploying NCP Package

Installation Steps

Step 1 - Extract the Installation Package

tar -I pbzip2 -xf ncp-rX.X.X-en.tar.bz2

Step 2 - Change Directory and Start the Installer

cd ncp-rX.X.X-en
sudo ./installer.sh

Step 3 - SSL Certificate Configuration

When prompted, choose whether to use a custom SSL certificate or the default self-signed certificate.

Option A - Custom SSL Certificate

Select y and provide paths to your certificate files:
[y/n]: y
→ Proceeding with custom domain SSL certificate installation..

Enter the path to the private key file: ./certs/server.pem
Enter the path to the certificate file: ./certs/server.crt.pem

Replace the certificate paths with the actual file locations on your system.

Option B - Default Self-Signed Certificate

Select n to use the bundled self-signed certificate:
[y/n]: n

→ Proceeding with self-signed certificates.

Step 4.a - Configure Host IP Address

Enter the server IP address that external services will use to reach Network Copilot:

Please provide the host IP address.
This IP will be used by external services to connect to the Network Copilot.

Enter the host IP address [10.10.5.64]: 10.10.5.64

→ Host IP saved to server_host_ip.txt

Step 4.b - Configure Public IP / Domain

You will also be prompted for a public IP or domain for external access. If it is the same as the host IP, press Enter to accept the default:

Please provide the public IP address or public domain for external access.
(If the public IP is the same as the host IP, just press Enter)

Enter the public IP or domain name [10.10.5.64]: 23.xx.xx.55

Step 5 - Configure LLM Endpoint

This step differs depending on which package you are installing.

Full Package (Bundled LLM):

The installer does not prompt for LLM details. The LLM service is pre-configured and starts automatically after the host IP is set:

Setting up the environment and loading essential dockers...
Loaded image: aviz/ncp-snmp-collector:v1.6.0
Loaded image: aviz/ncp-config-collector:v1.6.0
Loaded image: aviz/ncp-collector-db:latest
...

No LLM configuration is required for the full package. Bundled LLM defaults are applied automatically

Base Package (Remote LLM):

After configuring the host IP, you will be prompted to provide details for your remote LLM endpoint:

--- Remote VLLM Configuration ---
Please provide the connection details for your remote VLLM server.

Enter vLLM server URL [http://localhost:8000/v1/]: https://10.10.11.12:8000/v1/
Enter vLLM API key [sk-XXXXXXXXXXXXXXXXXXXX]: <your-api-key>
Enter vLLM model name [gpt-oss-120b]: gpt-oss-120b

Field	Default	Description
vLLM Server URL	http://localhost:8000/v1/	Full URL of the remote LLM endpoint Example- https://10.10.11.12:8000/v1/
vLLM API Key	sk-XXXXXXXXXXXXXXXXX	API key for authenticating with the LLM service
vLLM Model Name	gpt-oss-120b	Name of the model served by the endpoint

Additional LLMs can be configured after installation via the Web UI.

Step 6 - Installation Progress

The installer performs the following steps automatically:

• Installs required system prerequisites

• Loads and initializes Docker images

• Configures environment variables

• Sets up the Network Copilot runtime environment

Example output:
Installing prerequisites...
→ Prerequisites installed.

Installing Network Copilot...
Setting up the environment and loading essential dockers...
<...>

Step 7 - Access the Network Copilot UI

Once installation is complete, open a browser and navigate to:

https://<host-ip>

Step 8 - Activate License

After installation, activate the Network Copilot license from the UI.

Verify the Installation

Confirm that all services are running:

docker-compose ps -a

Name                    State   Ports
--------------------------------------------------------------
ncp-ui                  Up      0.0.0.0:443->443/tcp
ncp-api                 Up      0.0.0.0:9001->8000/tcp
ncp-flow-collector      Up      2055/udp, 6343/udp, 8099/tcp
ncp-syslog-collector    Up      514/udp
ncp-broker              Up      9092/tcp
ncp-connect             Up      8083/tcp
ncp-schema-registry     Up      8081/tcp
ncp-zookeeper           Up      2181/tcp
<...>

All containers should show Up state. If any service is not running, review the installer and Docker logs.

After a successful installation, the Docker service ncp-db-migrator will appear in an Exited (down) state. This is expected and does not indicate a failure.

For further assistance, raise a support ticket with us.