Skip to content
Documentation
Open the panel

Command lineCommands

A Git server on a company network

A GitLab or Bitbucket Data Center server that only the company network or its VPN reaches is connected through a node that sees it. The platform never connects to such a server: the node checks the token and lists the repositories. The panel does the same.

The node runs on a machine in the company network or on a computer with its VPN on. A Linux node can also connect to the company VPN itself, as the page The company VPN of a node describes.

1

Step 1: Open the server to the agents of a node

Give the entry as <address>:<port>, such as 10.20.0.5:443 or gitlab:80. --note says what the entry is for.

$ kcloud nodes network add acme-01 10.20.0.5:443 --note "Office GitLab"

Output

Added 10.20.0.5:443 to the list of acme-01; the node opens it to its agents within 30 seconds.

ENTRY          KIND  NOTE           GIT SERVERS              ADDED                     ID
10.20.0.5:443  host  Office GitLab  Office GitLab (Sandbox)  2026-03-14T09:30:00.000Z  0195a3c4-7e21-7b6d-9f40-3c81a4d2e600
private network: 1 entry applied at 2026-03-14T09:30:00.000Z
2

Step 2: List the entries of a node

The command shows the entries, the tokens whose server they cover and whether the node applied the list.

$ kcloud nodes network list acme-01

Output

ENTRY          KIND  NOTE           GIT SERVERS              ADDED                     ID
10.20.0.5:443  host  Office GitLab  Office GitLab (Sandbox)  2026-03-14T09:30:00.000Z  0195a3c4-7e21-7b6d-9f40-3c81a4d2e600
private network: 1 entry applied at 2026-03-14T09:30:00.000Z
3

Step 3: Close an address

Name the entry as kcloud nodes network list prints it.

$ kcloud nodes network remove acme-01 10.20.0.5:443 --yes

Output

Removed 10.20.0.5:443 from the list of acme-01; the node closes it within 30 seconds.

acme-01 opens no private address to its agents.
private network: 0 entries applied
4

Step 4: Add a token with the mark

--private-network marks a token of a server on the company network, and --server-url gives the address of the server. --ca-certificate gives the PEM file of the certificate authority of the company when it issued the certificate of the server.

$ kcloud credentials add --project sandbox --kind gitlab_token --label "Office GitLab" --server-url https://10.20.0.5 --private-network --ca-certificate company-ca.pem --commit-name "Anna Nowak" --commit-email anna.nowak@example.com --secret-stdin < gitlab-token.txt

Output

Stored Office GitLab (a5e1) as 0195a3c4-7e21-7b6d-9f40-3c81a4d2e600.
No node of the organization has 10.20.0.5:443 on its private network list. Add the server to the list of a node that reaches it: kcloud nodes network add <node> 10.20.0.5:443.

The node with access checks the token when it is added, when it is replaced, every night and on kcloud credentials verify. The column VERIFIED of kcloud credentials list shows the result.

VERIFIEDWhat it meansWhat to do
checking (node <node>)The node checks the token.Wait a moment.
valid (node <node>, <when>)The server accepted the token.Nothing.
invalid (node <node>, <when>)The server refused the token.Replace the secret: kcloud credentials rotate.
invalid: server did not answer node <node>The node did not reach the server.Check the network or the VPN of the node and run kcloud credentials verify.
invalid: node <node> does not trust the server certificateThe node does not trust the certificate of the server.Give the certificate of the authority: kcloud credentials rotate with --ca-certificate.
not checked: no node has accessNo node lists the server.kcloud nodes network add
not checked: node <node> outdated (<version>)The node cannot check tokens.Update the node.
waiting for node <node>The node with access has no connection.Check that the node runs and has a network.
5

Step 5: Register the repository

kcloud repositories available --project <project> --credential <token> prints the repositories the node fetched. When the node cannot fetch them, give the path with its subgroups to kcloud repositories add.

$ kcloud repositories add team/backend/shop --project sandbox --credential "Office GitLab"

Output

Registered team/backend/shop as 0195a3c4-7e21-7b6d-9f40-3c81a4d2e600, unchecked: its server is on a private network, so the agent finds its branch on the first clone.

Matches the panel at cloud.kikimora.dev.