Installation

Installation

Install

macOS (Apple Silicon):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling-cli_darwin_arm64_v8.0/smartling-cli
chmod +x smartling-cli && sudo mv smartling-cli /usr/local/bin/

macOS (Intel):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling-cli_darwin_amd64_v1/smartling-cli
chmod +x smartling-cli && sudo mv smartling-cli /usr/local/bin/

Linux (x86_64):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling-cli_linux_amd64_v1/smartling-cli
chmod +x smartling-cli && sudo mv smartling-cli /usr/local/bin/

Linux (arm64 — Graviton, Raspberry Pi 64-bit):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling-cli_linux_arm64_v8.0/smartling-cli
chmod +x smartling-cli && sudo mv smartling-cli /usr/local/bin/

Linux deb / Debian, Ubuntu (x86_64):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling_latest_linux_amd64.deb
sudo dpkg -i smartling_latest_linux_amd64.deb

Linux deb / Debian, Ubuntu (arm64):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling_latest_linux_arm64.deb
sudo dpkg -i smartling_latest_linux_arm64.deb

Linux rpm / RHEL, Fedora, Amazon Linux (x86_64):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling_latest_linux_amd64.rpm
sudo rpm -i smartling_latest_linux_amd64.rpm

Linux rpm / RHEL, Fedora, Amazon Linux (arm64):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling_latest_linux_arm64.rpm
sudo rpm -i smartling_latest_linux_arm64.rpm

The deb/rpm packages install the binary as /usr/bin/smartling-cli with a /usr/bin/smartling alias.

Windows (x86_64):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling-cli_windows_amd64_v1/smartling-cli.exe

Windows (arm64):

curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling-cli_windows_arm64_v8.0/smartling-cli.exe

From source:

go install github.com/Smartling/smartling-cli@latest

Verify (optional):

# Get the checksum manifest
curl -OL https://smartling-connectors-releases.s3.amazonaws.com/cli/checksums.txt

# Verify deb/rpm packages directly (filenames already match)
sha256sum -c checksums.txt --ignore-missing      # Linux
shasum -a 256 -c checksums.txt                   # macOS

For raw binary downloads, the file lands as smartling-cli locally but is listed in checksums.txt under its archive name (e.g. smartling-cli_latest_linux_amd64). Compare the hashes manually:

sha256sum smartling-cli                          # or shasum -a 256 on macOS
grep smartling-cli_latest_linux_amd64 checksums.txt

The two hex values should match. Substitute darwin_arm64, linux_arm64, windows_amd64.exe, etc. for your platform.

Version Compatibility

Version	Status	Key Features	Use Case
Latest	Current	See release notes for details	Recommended for all users
2.5	Stable	Enhanced documentation, Cobra v1.10.1, LLM-optimized docs	Latest stable release
2.4.1	Stable	File type override support	Flexible file handling
2.4	Stable	Updated file type support, improved file handling	Enhanced file operations
2.3	Stable	Fixed files push with upload directives	Bug fixes for uploads
2.2	Stable	Job-based uploads, enhanced config	Job workflow support
2.1	Stable	MT commands, config hierarchy	Machine translation features
1.7	Legacy	Basic file operations	Legacy systems only

Legacy Versions

Version 2.1

If you need version 2.1 for compatibility:

Windows

curl --output smartling-cli.exe https://github.com/Smartling/smartling-cli/releases/download/2.1/smartling.windows.exe

macOS

curl --output smartling-cli https://github.com/Smartling/smartling-cli/releases/download/2.1/smartling.darwin \
&& sudo chmod +x smartling-cli \
&& sudo mv smartling-cli /usr/local/bin/

Linux

curl --output smartling-cli https://github.com/Smartling/smartling-cli/releases/download/2.1/smartling.linux \
&& sudo chmod +x smartling-cli \
&& sudo mv smartling-cli /usr/local/bin/

Version 1.7

⚠️ Legacy version - use only if required for existing workflows

Windows

curl --output smartling-cli.exe https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling.windows-1.7.exe

macOS

curl --output smartling-cli https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling.darwin-1.7 \
&& sudo chmod +x smartling-cli \
&& sudo mv smartling-cli /usr/local/bin/

Linux

curl --output smartling-cli https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling.linux-1.7 \
&& sudo chmod +x smartling-cli \
&& sudo mv smartling-cli /usr/local/bin/

Installation Methods

CI/CD Integration

GitHub Actions

- name: Install Smartling CLI
  run: |
    curl -L https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling.linux \
      -o smartling-cli
    chmod +x smartling-cli
    sudo mv smartling-cli /usr/local/bin/

GitLab CI

before_script:
  - curl -L https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling.linux -o smartling-cli
  - chmod +x smartling-cli
  - export PATH="$PWD:$PATH"

Jenkins

pipeline {
    agent any
    stages {
        stage('Install CLI') {
            steps {
                sh 'curl -L https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling.linux -o smartling-cli'
                sh 'chmod +x smartling-cli'
            }
        }
    }
}

Verification

Verify your installation:

# Check version
smartling-cli --version

# Test basic functionality
smartling-cli --help

# Verify authentication setup
smartling-cli init

System Requirements

• Operating System: Windows 10+, macOS 10.14+, Linux (any modern distribution)
• Architecture: x86_64 (AMD64)
• Network: HTTPS access to api.smartling.com
• Disk Space: ~20MB for binary and configuration

Troubleshooting

Permission Issues (macOS/Linux)

# If binary is not executable
chmod +x smartling-cli

# If moved to system path fails
sudo chown $(whoami) /usr/local/bin/smartling-cli

Network Issues

# Test connectivity
curl -I https://api.smartling.com/health

# Use proxy if needed
export HTTPS_PROXY=http://proxy.company.com:8080
smartling-cli --help

Path Issues

# Verify installation location
which smartling-cli

# Add to PATH if needed (add to ~/.bashrc or ~/.zshrc)
export PATH="/usr/local/bin:$PATH"

Next Steps

After installation:

1. Configure authentication: Set up your Smartling credentials
2. Review examples: Learn common usage patterns
3. Check migration guide: If upgrading from older versions

Release Information

• Version history - All previous versions
• Breaking changes - Important compatibility notes