Deploying the NCP Package

Installation Steps

1. Extract the Installation Package

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

For the base package (no bundled LLM):

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

2. Change Directory and Start the Installer

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

3. SSL Certificate Configuration (Optional)

Network Copilot supports custom SSL certificate integration.

When prompted:

Would you like to install a custom domain SSL certificate?
(If you select 'n', the installation will proceed with a self-signed certificate.)
[y/n]:

Option A: Use a Custom SSL Certificate

Select y and provide the 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 private key and certificate paths with the correct file locations on your system.

Option B: Use the Default Self-Signed Certificate

Select n to use the self-signed certificate bundled with NCP:

[y/n]: n
→ Proceeding with self-signed certificates.

4. Configure Host IP Address

Provide the server IP address that external services will use to connect to 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.20.5.33
→ Host IP saved to server_host_ip.txt

5. Configure LLM Endpoint

During installation, you will be prompted to configure the LLM endpoint:

Please provide LLM endpoint details.
Enter LLM Host IP: [ncp-vllm]:
Enter LLM Host Port: [8000]:
Would you like to use a custom API Key for the LLM Service?
(If you select 'y', you will be prompted for the API key.)
[y/n] [n]:

• For NCP with integrated LLM, defaults are pre-populated and can be accepted.

• For the base package, provide the external LLM details now or configure them later.

Example:

→ NCP LLM set to https://ncp-vllm:8000 with API Key configured.

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...
<...>

6. Access the Network Copilot UI

Once installation completes, access the UI using:

https://<host-ip>

Example:

https://10.2.3.33

7. Activate License

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

Verify the Installation

Verify that all services are running successfully.

docker-compose ps -a

Example output:

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 be in the Up state. If any service is not running, review the installer and Docker logs.

For further assistance, raise a support ticket with us.

After a successful installation, the Docker service ncp-db-migrator will appear in an Exited (down) state.

This is expected behavior and does not indicate a failure.