Skip to content

Latest commit

 

History

History
135 lines (80 loc) · 3.86 KB

README.md

File metadata and controls

135 lines (80 loc) · 3.86 KB

govm Logo

govm - Go Version Manager

Go Report Card License: MIT GitHub release GitHub issues GitHub stars GitHub contributors

govm is a simple yet powerful Go version manager that allows you to seamlessly install, switch, and manage multiple Go versions on your system. Whether you're working on different projects requiring different Go versions or just need an easy way to manage your Go environment, govm has got you covered.

With govm, you can quickly install any Go version, switch between them effortlessly, and ensure your projects always run with the correct Go version. It eliminates the hassle of manually downloading, configuring, and maintaining multiple Go installations.

🚀 Why Use govm?

  • Effortless Installation – Install any Go version with a single command.

  • Seamless Switching – Easily switch between different Go versions for different projects.

  • Environment Isolation – Avoid conflicts between Go versions across projects.

  • Lightweight & Fast – Optimized for performance with minimal overhead.

  • Persistent Versioning – Set and persist default Go versions globally or per project.

  • Automatic Updates – Keep your Go environment up to date with the latest releases.

  • Cross-Platform Support – Works on Linux, macOS, and Windows.

  • Minimal and Fast – Lightweight with optimized performance.

  • Uninstall and Update – Easily update or remove govm when needed.

  • Custom Go Cache Paths – Define custom directories for Go versions.

🛠️ Installation

Linux and macOS

To install govm on Linux or macOS, run the following command:

curl -o- https://raw.githubusercontent.com/emmadal/govm/main/scripts/install.sh | bash

or

wget -qO- https://raw.githubusercontent.com/emmadal/govm/main/scripts/install.sh | bash

Windows

To install govm on Windows, open PowerShell as Administrator and run:

iwr -useb https://raw.githubusercontent.com/emmadal/govm/main/scripts/install.ps1 | iex

🔧 Usage

Installing a Go version

govm install <version>

Using a specific Go version

govm use go<version>

Listing installed Go versions

govm list

Removing a Go version

govm rm go<version>

Updating govm

You can update govm to the latest version using the following command:

govm update

Uninstalling govm

We provide a command to uninstall govm from your system. This will remove the govm binary and all installed Go versions managed by govm. Please note that this will not remove any Go versions installed manually.

You can uninstall govm using the following command:

govm uninstall

🛠️ Requirements

  • Bash 3.2 or later (for Linux/macOS)
  • PowerShell 5.1 or later (for Windows)
  • A POSIX-compliant system (Linux, macOS) or Windows 7/10/11

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

This project is licensed under the MIT License—see the LICENSE file for details.

Support

If you encounter any issues or have questions, please file an issue on the GitHub repository.