Skip to Content
Skip to Content
Connect a PC tunnel

Connect a PC tunnel

A PC tunnel enables features that need access to the connected PC. Keep the connection process running while you work.

Before connecting

  • Complete CLI installation.
  • Get a connection token from the PC connection instructions in the web interface.

Connect the tunnel

Issue a PC connection token in the web interface, then run the provided command.

aipctl tunnel link CONNECTION_TOKEN
  1. Replace CONNECTION_TOKEN with your token.
  2. Check the connection status in the terminal.
  3. Keep the process running while performing tasks that need the PC connection.
  4. Press Ctrl+C in that terminal to disconnect.

Interactive terminals show connection status and transfer information on screen. Other execution environments use log output. Check the current account’s connection status with:

aipctl admin tunnel status

Sharing a token can allow unintended connections. When asking for help, hide tokens and raw configuration and share only the error details.

View tunnel settings and create tokens

Query connection settings or create a token. Use the web interface’s connection instructions where CLI execution is restricted.

aipctl admin tunnel config

Check the connection command, connection limit, and current connection count. Secrets in the command are masked by default. If you need the full command, reveal it in a private terminal.

aipctl admin tunnel config --show-sensitive

This output may contain a connection token. Do not share the screen or logs.

aipctl admin tunnel token

token requests token creation; the success message does not display the token itself. Where permitted, retrieve the connection command through the web interface or admin tunnel config. Check how issuing a token affects existing connections. If the result is unclear, check current connection status before requesting another token.

If the connection fails

  • Check that the token was issued for the organization you intend to use.
  • Check that the tunnel process is running.
  • Use admin tunnel status to check the connection.
  • If you moved to another PC or environment, reconnect using that environment’s instructions.
Last updated on