Lokasi ngalangkungan proxy:   [ UP ]  
[Ngawartoskeun bug]   [Panyetelan cookie]                
Skip to content

docs: improve Linux manual installation guide#497

Open
sanki92 wants to merge 3 commits intotofuutils:mainfrom
sanki92:fix/issue-263-linux-manual-install
Open

docs: improve Linux manual installation guide#497
sanki92 wants to merge 3 commits intotofuutils:mainfrom
sanki92:fix/issue-263-linux-manual-install

Conversation

@sanki92
Copy link
Copy Markdown

@sanki92 sanki92 commented Oct 5, 2025

Improve Linux manual installation guide

Description

The current Linux manual installation documentation was pretty bare-bones - just a one-liner pointing to releases. This PR addresses issue #263 by adding proper installation instructions that actually help users get tenv running on their systems.

What's changed

Added a proper Linux manual installation section that covers:

  • Prerequisites (curl only) with install commands for different distros
  • System-wide installation (for users with sudo access)
  • User-local installation (for users without sudo)
  • Multiple installation approaches including custom directories and symlinks
  • Shell configuration examples for bash/zsh
  • Verification steps

Tasks completed

  • Added Linux manual installation prerequisites section
  • Created system-wide installation instructions with multiple options
  • Created user-local installation instructions
  • Added shell configuration examples (bash, zsh, profile)
  • Included verification steps and helpful notes
  • Used community-suggested commands from issue discussion
  • Maintained existing documentation structure
  • Renamed prerequisite sections to be more descriptive (CentOS/Fedora, Debian/Ubuntu)
  • Updated prerequisites to use only curl (no jq dependency)
  • Updated all installation commands to use direct download URLs instead of API calls
  • Addressed all review feedback from maintainers

Testing

  • Verified documentation formatting
  • Commands are designed to be copy-pastable and automation-friendly

Fixes #263

- Added comprehensive Linux manual installation instructions
- Included both system-wide and user-local installation options
- Added prerequisites section for Linux manual installation
- Improved commands based on community suggestions in issue tofuutils#263
- Used wget instead of curl for better compatibility
- Added clear examples for different installation scenarios

Fixes tofuutils#263

Signed-off-by: shanky <sankalpt92@gmail.com>
@sanki92 sanki92 force-pushed the fix/issue-263-linux-manual-install branch from 88dc174 to 85c0c26 Compare October 5, 2025 20:57
@kvendingoldo
Copy link
Copy Markdown
Collaborator

Thanks! I'll check it tonight

Comment thread README.md

</details>

<details markdown="1"><summary><b>Linux: Manual Installation Prerequisites</b></summary><br>
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I suggest you rename sections:
Linux: RPM -> Linux: CentOS/Fedora
Linux: dkpg -> Linux: Debian/Ubuntu

And add new information there. I'm not sure that we need wget, and jq. Curl is enough to install tenv and cosign.

Comment thread README.md Outdated

```sh
# Download and install tenv system-wide
wget -q -O - "https://api.github.com/repos/tofuutils/tenv/releases/latest" | \
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use curl here.

Comment thread README.md Outdated

```sh
# Download to /usr/bin (requires sudo)
wget -q -O - "https://api.github.com/repos/tofuutils/tenv/releases/latest" | \
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use curl here

Comment thread README.md Outdated
```sh
# Install to /usr/local/tenv and create symlinks
sudo mkdir -p /usr/local/tenv
wget -q -O - "https://api.github.com/repos/tofuutils/tenv/releases/latest" | \
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use curl here

Comment thread README.md Outdated
mkdir -p ${BINDIR}

# Download and install tenv locally
wget -q -O - "https://api.github.com/repos/tofuutils/tenv/releases/latest" | \
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use curl here

- Renamed 'Linux: RPM' to 'Linux: CentOS/Fedora'
- Renamed 'Linux: dkpg' to 'Linux: Debian/Ubuntu'
- Updated prerequisites to use curl instead of wget and jq
- Replaced all wget commands with curl equivalents
- Updated installation notes to reflect curl usage

Addresses feedback from kvendingoldo

Signed-off-by: shanky <sankalpt92@gmail.com>
- Removed jq from prerequisites completely
- Updated all installation commands to use direct download URLs

Signed-off-by: shanky <sankalpt92@gmail.com>
@sanki92
Copy link
Copy Markdown
Author

sanki92 commented Oct 6, 2025

Hi @kvendingoldo! Thanks for the review feedback. I've addressed all your suggestions.

The PR description has also been updated to reflect these changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Linux manual installation guide is largely incomplete

2 participants