Setting up OS Login access on an existing VM

If you need to set up a connection to a deployed VM via OS Login, you can install the OS Login agent on the VM yourself.

Enabling access via OS LoginEnabling access via OS Login

To set up OS Login access to an existing VM:

1. Enable access via OS Login at the organization level.

2. Connect to the VM over SSH.

3. Install the OS Login agent on the VM. Depending on the VM's OS, run one of the following commands:

   Note

   The Ubuntu 24.04 public image has a pre-installe OS Login agent, so you do not need to install it yourself.

   Ubuntu 22.04

   Ubuntu 20.04

   Ubuntu 18.04

   CentOS 7

   Debian 11

   AlmaLinux 9

   curl https://storage.yandexcloud.net/oslogin-configs/ubuntu-22.04/config_oslogin.sh | bash
   

   curl https://storage.yandexcloud.net/oslogin-configs/ubuntu-20.04/config_oslogin.sh | bash
   

   curl https://storage.yandexcloud.net/oslogin-configs/ubuntu-18.04/config_oslogin.sh | bash
   

   curl https://storage.yandexcloud.net/oslogin-configs/centos-7/config_oslogin.sh | bash
   

   curl https://storage.yandexcloud.net/oslogin-configs/debian-11/config_oslogin.sh | bash
   

   curl https://storage.yandexcloud.net/oslogin-configs/almalinux-9/config_oslogin.sh | bash
   

4. Enable access via OS Login on the VM.

You can now connect to the VM via OS Login using either the YC CLI or a standard SSH client. To connect, you can use an SSH certificate or SSH key, which you first need to add to organization user or service account profile in Yandex Cloud Organization.

Enabling access via OS LoginEnabling access via OS Login

To enable access without OS Login, the VM must contain the public part of the SSH key. If the VM was created without an SSH key or the key was lost, add the key and user manually before disabling OS Login access.

To be able to connect to the VM over SSH without using OS Login:

1. Disable access via OS Login.

   Management console

   CLI

   1. In the management console, select the folder the VM belongs to.
   2. Select Compute Cloud.
   3. In the left-hand panel, select Virtual machines and click the name of the VM.
   4. In the top-right corner, click Edit VM.
   5. Under Access, select SSH key.
   6. Click Save changes.

   Run this command:

   yc compute instance update --name <VM_name> \
   --folder-id <folder_ID> \
   --metadata enable-oslogin=false
   

   Make sure that access via OS Login is disabled:

   yc compute ssh --name <VM_name> --folder-id <folder_ID>
   

   Result:

   ...
   username@12.345.***.***: Permission denied (publickey).
   ...
   

2. Connect to the VM over SSH.

3. Run the following command to delete OS Login packets:

   Linux

   curl https://storage.yandexcloud.net/oslogin-configs/common/remove_oslogin.sh | bash
   

   When deleting, you will be prompted to confirm the deletion of the cron and unscd packets. To confirm, type y and press Enter.