Docs
CLI
Installation

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

  1. Download the latest release for macOS from the GitHub releases page
  2. Extract the binary
  3. 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

  1. Download the latest release for Linux from the GitHub releases page
  2. Extract the binary
  3. 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

  1. Download the latest release for Windows from the GitHub releases page
  2. Extract the binary
  3. 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.

Authentication