goconfig

A Go installation and version manager for Linux and macOS.

Features

• Install, update, and remove Go with a single command
• Multi-version management: install and switch between multiple Go versions
• Automatic environment configuration (GOPATH, PATH)
• Download caching for faster reinstalls
• Checksum verification for secure downloads
• Proxy support for corporate environments
• Shell completions for bash and zsh
• Self-update capability

Supported Platforms

• Operating Systems: Linux, macOS
• Architectures: amd64 (x86_64), arm64 (aarch64), ppc64le, s390x

Requirements

• wget or curl
• tar

Usage

./go.sh [OPTIONS] <COMMAND> [ARGS]

Options

| Option | Description | |--------|-------------| | -q, --quiet | Suppress non-error output | | -v, --verbose | Enable verbose/debug output | | --version | Show goconfig version |

Commands

Installation & Updates

| Command | Description | |---------|-------------| | install | Install the latest Go version | | install <VERSION> | Install a specific Go version (e.g., 1.22.0) | | remove | Remove Go installation | | remove --env | Remove Go installation and shell configuration | | update | Update Go to the latest version |

Environment

| Command | Description | |---------|-------------| | env | Set up Go environment variables in your shell config |

Version Management

| Command | Description | |---------|-------------| | versions | List all available Go versions (remote) | | list | List locally installed Go versions | | use <VERSION> | Switch to a specific installed version |

Maintenance

| Command | Description | |---------|-------------| | status | Show installation status and health check | | cache | Manage download cache (clear) | | config | Show current configuration | | config save | Save current configuration to file | | self-update | Update goconfig to the latest version | | completions [bash\|zsh] | Generate shell completions | | help | Show help message |

Examples

# Install the latest Go version
./go.sh install

# Install a specific version
./go.sh install 1.22.0

# Update to the latest version
./go.sh update

# Check installation status
./go.sh status

# List available versions
./go.sh versions

# Switch between installed versions
./go.sh use 1.21.0

# Generate and install bash completions
./go.sh completions bash >> ~/.bashrc

Configuration

goconfig can be configured via environment variables or a config file (~/.goconfig).

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | GO_INSTALL_DIR | /usr/local | Go installation directory | | GO_WORKSPACE | $HOME/go | Go workspace (GOPATH) | | GO_VERSIONS_DIR | $HOME/.go/versions | Directory for multiple Go versions | | GO_CACHE_DIR | $HOME/.cache/goconfig | Download cache directory | | HTTP_PROXY | - | HTTP proxy for downloads | | HTTPS_PROXY | - | HTTPS proxy for downloads |

Custom Installation Directory

To install Go to a user-writable location (no sudo required):

export GO_INSTALL_DIR="$HOME/.local"
./go.sh install

License

Apache License, Version 2.0

Contributors

• Rafael Sene rpsene@gmail.com
• Hiro Miyamoto miyamotoh@fuji.waseda.jp