Configure your personal computer for Standalone Portal

Configure your personal computer to trust a Standalone/On-Prem Portal that uses a self-signed SSL certificate. Trusting the certificate is required to access the Portal Web and to use virtualUSB, Kobiton CLI, and any AI coding assistant connected through the Kobiton MCP server.

Before you start

You’ll need to complete the following:

Trust self-signed SSL certificate (Standalone/On-Prem only)

These steps are only necessary if the Standalone/On-Prem Portal uses a self-signed SSL certificate. Import the certificate on each end-user computer that accesses the Portal Web, runs virtualUSB, runs Kobiton CLI commands, or connects through the Kobiton MCP server.

  • macOS

  • Windows

  • Linux

Request the IT administrator of your organization for the root CA certificate that issued the SSL end-entity certificate. It is typically named root.crt or ca.crt. Transfer the certificate file to the computer.

Open the Keychain Access application.

Open Finder, go to the location of the root CA certificate file, then drag and drop the file into the Keychain Access application.

Double-click on the newly added certificate file. In the dialog, choose the Always Trust option from the dropdown list for the two fields:

  • Secure Sockets Layer (SSL)

  • X.509 Basic Policy

The trust option for the imported certificate in keychain access with the 2 options set as Always Trust

Close the dialog and enter the admin password of the user workstation to save the changes.

Request the IT administrator of your organization for the root CA certificate that issued the SSL end-entity certificate. It is typically named root.crt or ca.crt. Transfer the certificate file to the computer.

On the Windows machine, double-click the file, then select Install Certificate on the Certificate window.

The certificate information screen with an option to Install Cerficicate

On the next screen, choose Local Machine. This requires administrators privileges.

The Certificate Import Wizard with the Store Location set to Local Machine

On the next screen, choose Place all certificates in the following store, then select Browse.

The Certificate Store selector with the option Place all certificates in the following store selected

Choose Trusted Root Certification Authorities, then select OK.

The Select Certificate Store screen with Trusted Root Certification Authorities selected

Select Next, then Finish. The root CA certificate is now imported to the end-user workstation trust store.

Request the IT administrator of your organization for the root CA certificate that issued the SSL end-entity certificate. It is typically named root.crt or ca.crt. Transfer the certificate file to the computer, then trust it using the steps for your distribution:

  • Debian-based: copy the certificate to /usr/local/share/ca-certificates (create the directory if it does not exist), then run update-ca-certificates as root.

  • Arch or Fedora: copy the certificate to /etc/ca-certificates/trust-source/anchors, then run update-ca-trust as root.

After importing the certificate, restart the Chrome browser, Kobiton CLI, the virtualUSB application, or any AI coding assistant connected through the Kobiton MCP server before connecting to the Portal.