Skip to content

Conversation

@1yam
Copy link
Member

@1yam 1yam commented Jan 13, 2026

This pull request updates the CLI documentation for Aleph, focusing on improving clarity, consistency, and feature coverage for account, file, and instance management commands. The changes introduce new options, clarify argument types, and expand documentation for hardware wallet (Ledger) support, file uploads, and instance operations.

Account Management Documentation Improvements:

  • Added --key-format option for specifying private key encoding and improved the description for --debug in aleph account create.
  • Expanded aleph account config options to include Ledger support, derivation path, non-interactive mode, and clarified option names and descriptions.
  • Added documentation for listing multiple keys, including Ledger accounts, with the new aleph account list command and its options.
  • Added section describing default account configuration settings.

File Management Documentation Updates:

  • Updated aleph file commands to support uploading directories, downloading files, and clarified command descriptions.
  • Added --storage-engine and --chain options to file upload, pin, forget, and list commands for greater flexibility and multi-chain support [1] [2] [3] [4].
  • Improved descriptions for debug logging and output format options [1] [2].

Instance Management Documentation Refinements:

  • Restricted --hypervisor to qemu only and clarified override behavior for --vcpus, --memory, and --rootfs-size in aleph instance create.
  • Standardized argument types for all instance subcommands (e.g., VM_ID is now consistently TEXT) and improved domain option descriptions [1] [2] [3] [4] [5].
  • Fixed typos and improved section headings for clarity [1] [2] [3] [4] [5].

These updates make the CLI documentation more comprehensive, user-friendly, and aligned with the latest CLI features and best practices.

This pull request updates the Aleph CLI documentation to introduce and clarify support for "credits" as a new payment method for instances, alongside existing methods. It also adds documentation for credits management commands and improves guidance for users regarding payment options and related documentation links.

**Payment method updates:**
* Added "credit" as a supported value for the `--payment-type` option in both `aleph instance create` and `aleph instance confidential` command documentation, clarifying that users can now pay using Aleph Cloud credits [[1]](diffhunk://#diff-76866983bf4f2551f94e6d9562d39c16ceb5f042f35d8906deb13e3959fcca34L48-R48) [[2]](diffhunk://#diff-76866983bf4f2551f94e6d9562d39c16ceb5f042f35d8906deb13e3959fcca34L443-R453) [[3]](diffhunk://#diff-3616ed056fecf9111355459a6196a45ff0309e31e799a5110fead252a61267e5R87).
* Updated the payment method descriptions and notes to reference [Credits](./credits.md), providing a direct link to further information.

**Credits management documentation:**
* Added a new "Credits Management" section to the CLI documentation index and included a reference to the corresponding command group file.
* Listed new commands under the Credits domain: `aleph credits show` and `aleph credits history`.

**Usage examples:**
* Provided a new example command for creating an instance using credits as the payment method.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants