Skip to main content

Login Authentication

Before using Lovrabet CLI, you need to log in to your account. This process is like opening an app on your phone for the first time and needing to log in.

Why Do You Need to Log In?​

After logging in, the CLI can:

  • Get your project information from the backend
  • Auto-generate API call code
  • Access features that only you can use

Simply put, it lets the system know "who you are".

How to Log In​

Just one command:

# Execute in terminal (Windows users recommend using Git Bash)
lovrabet auth

Then press Enter and wait for the browser to open automatically.

Login Authentication Demo

Login Process Explained​

Don't worry, the entire process is very simple:

1️⃣ Check Login Status​

The CLI first checks if you are already logged in. If you are, there's no need to repeat the operation.

2️⃣ Start Local Service​

If login is needed, the CLI will start a temporary server on your computer (don't worry, only accessible locally).

3️⃣ Open Browser​

The CLI will display the login link and try to automatically open the browser. If the browser doesn't open automatically, you can manually copy the displayed link and open it in your browser.

If the browser opens automatically: Just enter your username and password on the page.

If the browser doesn't open automatically:

  1. Find the login link displayed in the terminal (usually in https://localhost:xxxx format)
  2. Copy this link
  3. Manually open a browser, paste the link and visit
  4. Enter your username and password on the opened page

4️⃣ Complete Login​

After successful login, the browser will redirect back to a local page, and the CLI will automatically save your login information.

5️⃣ Exit​

After the terminal displays "Login successful", press the q key to exit.

Where Is Login Information Stored?​

Your login information is securely stored in:

  • Cookie file: ~/.lovrabet/cookie
  • Configuration directory: ~/.lovrabet/

Explanation: ~ represents your user home directory. On Windows it's C:\Users\YourUsername, on Mac/Linux it's /Users/YourUsername or /home/YourUsername.

Common Issues​

Issue 1: Browser Doesn't Open Automatically​

Solution:

  • Manually copy the login link displayed in the terminal and open it in your browser
  • Windows users: In Git Bash, you can right-click to select and copy the link
  • If you frequently encounter this problem, check your system's default browser settings

Issue 2: Want to Switch to Another Account​

Solution:

  1. Delete the login information file: 
    rm ~/.lovrabet/cookie
  2. Log in again: 
    lovrabet auth

Issue 3: Browser Shows "Insecure Connection"​

Reason: The local service uses a self-signed certificate, and the browser will display a warning.

Solution: Click "Advanced" or "Details", then choose "Continue to" or "Proceed to".

Tips​

  • First-time use requires login: Please run lovrabet auth before using other features
  • Login status persists: Once logged in, you won't need to log in again for a long time
  • Safe and secure: Login information is only saved on your local computer