Skip to main content
Activate a new 2FA method by verifying the code

​
Usage

vastai tfa activate CODE --secret SECRET [--sms] [--phone-number PHONE_NUMBER] [--label LABEL]

​
Arguments

​
code
string
required
6-digit verification code from SMS or Authenticator app

​
Options

​
--sms
boolean
Use SMS 2FA method instead of TOTP
​
--secret
string
Secret token from setup process (required)
​
--phone-number
string
Phone number for SMS method (E.164 format)
​
-l
string
Label for the new 2FA method (alias: --label)

​
Description

Complete the 2FA setup process by verifying your code. For TOTP (Authenticator app):
  1. Run ‘vastai tfa totp-setup’ to get the manual key/QR code and secret
  2. Enter the manual key or scan the QR code with your Authenticator app
  3. Run this command with the 6-digit code from your app and the secret token from step 1
For SMS:
  1. Run ‘vastai tfa send-sms —phone-number <PHONE_NUMBER>’ to receive SMS and get secret token
  2. Run this command with the code you received via SMS and the phone number it was sent to
If this is your first 2FA method, backup codes will be generated and displayed. Save these backup codes in a secure location!

​
Examples

vastai tfa activate --secret abc123def456 123456
 vastai tfa activate --secret abc123def456 --phone-number +12345678901 123456
 vastai tfa activate --secret abc123def456 --phone-number +12345678901 --label "Work Phone" 123456

​
Global Options

The following options are available for all commands:
OptionDescription
--url URLServer REST API URL
--retry NRetry limit
--rawOutput machine-readable JSON
--explainVerbose explanation of API calls
--api-key KEYAPI key (defaults to ~/.config/vastai/vast_api_key)