Skip to content

Onboarding: Clone URL uses HTTPS which fails for push #4921

@styltsou

Description

@styltsou

During the onboarding process, the clone command provided uses an HTTPS URL (e.g., https://github.com/org/docs.git). When users try to push changes, it fails with an authentication error:

fatal: could not read Username for 'https://github.com': No such device or address

This is likely because:

  1. GitHub has deprecated HTTPS password authentication
  2. Users may not have configured Git credentials for HTTPS
  3. SSH would work but isn't offered as an option

Steps to reproduce:

  1. Complete Mintlify onboarding with a new docs repository
  2. Copy the clone URL provided (HTTPS format)
  3. Make a change and try to git push
  4. Push fails with authentication error

Suggested fix:

  • Use SSH URLs by default (e.g., git@github.com:org/docs.git)
  • Or detect user's Git configuration and prefer their preferred protocol
  • Or show a warning during onboarding about authentication setup

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions