Skip to content

Documentation mismatch: the alias problem in installation. #6957

@wadeio

Description

@wadeio

Description:

I found a discrepancy between the Chinese and English documentation regarding how to activate the acme.sh alias after installation:

  1. Documentation Inconsistency: The Chinese README suggests running source ~/.bashrc to activate the alias. However, the English README correctly states "Close and reopen your terminal."
  2. Technical Root Cause: The installer writes the alias/environment configuration to ~/.profile by default, not ~/.bashrc. Therefore, source ~/.bashrc does not load the changes.
  3. Better Alternative: For SSH users, running source ~/.profile is a much more convenient option than closing and reopening the terminal.
  4. Shell Compatibility: The current installation logic fails for Fish Shell users. The syntax in .profile is incompatible with Fish, and Fish does not source .profile by default.

Request:

  • Please synchronize the Chinese README with the English version.
  • Update the instructions to recommend source ~/.profile for immediate activation.
  • Consider adding a compatibility note or support for Fish Shell users.

Environment:

  • OS: Debian 13

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions