Installing tcloud CLI
This guide covers how to install the Thalassa Cloud CLI (tcloud) on different operating systems.
Prerequisites
- A supported operating system (macOS, Linux, Windows)
- Network access to download the binary or access to Homebrew (macOS)
Installation Methods
macOS
Using Homebrew (Recommended)
The easiest way to install tcloud on macOS is using Homebrew:
brew install thalassa-cloud/tap/tcloud
Manual Installation
- Download the latest release for macOS from the GitHub releases page
- Extract the binary
- Move it to your PATH:
# For Intel Macs
sudo mv tcloud-darwin-amd64 /usr/local/bin/tcloud
# For Apple Silicon Macs
sudo mv tcloud-darwin-arm64 /usr/local/bin/tcloud
# Make it executable
chmod +x /usr/local/bin/tcloud
Linux
Manual Installation
- Download the latest release for Linux from the GitHub releases page
- Extract the binary
- Move it to your PATH:
# For x86_64 systems
sudo mv tcloud-linux-amd64 /usr/local/bin/tcloud
# For ARM64 systems
sudo mv tcloud-linux-arm64 /usr/local/bin/tcloud
# Make it executable
chmod +x /usr/local/bin/tcloud
Using Package Managers
Some Linux distributions may have tcloud available in their package repositories. Check your distribution’s package manager.
Windows
Manual Installation
- Download the latest release for Windows from the GitHub releases page
- Extract the binary
- Add the directory containing
tcloud.exe
to your PATH environment variable
Verifying Installation
After installation, verify that tcloud is working correctly:
tcloud version
You should see output similar to:
tcloud version v0.4.1
Shell Completion
To enable shell completion for better user experience:
Bash
# Generate completion script
tcloud completion bash > ~/.local/share/bash-completion/completions/tcloud
# Or add to your ~/.bashrc
echo 'source <(tcloud completion bash)' >> ~/.bashrc
Zsh
# Generate completion script
tcloud completion zsh > ~/.zsh/completions/_tcloud
# Or add to your ~/.zshrc
echo 'source <(tcloud completion zsh)' >> ~/.zshrc
Fish
# Generate completion script
tcloud completion fish > ~/.config/fish/completions/tcloud.fish
PowerShell
# Generate completion script
tcloud completion powershell > $PROFILE
Updating
Homebrew (macOS)
brew upgrade tcloud
Manual Installation
Download the latest release and replace the existing binary following the same installation steps.
Troubleshooting
Permission Denied
If you get a permission denied error:
chmod +x /usr/local/bin/tcloud
Command Not Found
If the tcloud
command is not found, ensure the binary is in your PATH:
# Check if tcloud is in PATH
which tcloud
# Add to PATH if needed (Linux/macOS)
export PATH=$PATH:/path/to/tcloud/directory
Version Issues
If you encounter version compatibility issues, ensure you’re using the latest version:
tcloud version
For more help, check the GitHub repository or create an issue.