Skip to content

Installation

Jump to bottom
Dmitry Studynsky edited this page Oct 10, 2025 · 10 revisions

Installation

Download the Latest Release

Visit our GitHub Releases page to find the latest stable version and release notes. Below are installation instructions for all platforms.

Windows

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

macOS

curl --output smartling-cli https://smartling-connectors-releases.s3.amazonaws.com/cli/smartling.darwin \
&& 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 \
&& sudo chmod +x smartling-cli \
&& sudo mv smartling-cli /usr/local/bin/

From Source

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

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

Clone this wiki locally