Using the serial console for virtual machines in Nebius AI Cloud

The serial console is a browser-based, text-only session to your virtual machine’s serial port that you can use to connect to and troubleshoot a VM when normal network access is unavailable. You can also use it for the first-boot setup on custom or third-party images when SSH is not yet configured.

​

Prerequisites

• Add a user for connections to the VM the serial console of which you want to access.
• Make sure you are in a group that has at least the compute.serial-console-user role within your tenant or project. You can check this in the Administration → IAM section of the web console.

​

Using the serial console

To open the serial console:

​

Limits and concurrent sessions

Only one serial console session can be active for a given VM at a time. If someone else already has a session open, a new connection will fail until the other session ends. Be sure to close any unused console windows in your browser if you no longer need the session.

​

Troubleshooting

​

Resource not found

In this case, the VM might be stopped. Start the VM and then open the serial console again.

​

Connection failed

Another serial console session is already open for this VM. Coordinate with other users, or wait and try again.

​

Access denied

If you can’t access the serial console and you don’t have permission to use it, contact the administrator of your tenant. Ask them to add you to the group with at least the compute.serial-console-user role.

​

Checking Audit Logs for serial console events

Audit Logs records all serial console connection attempts, including failed ones. To find these events, filter them by the service: "service.name='COMPUTE_CONSOLE'". For failed attempts, check the event’s response.error_message field. For example, the Permission denied message in the field indicates access denied.

​

See also

• Connecting to virtual machines
• Viewing serial logs of virtual machines