How to Install GO (golang 1.22) in Ubuntu 22.04

Last updated: March 9, 2024 — 2 Comments

Go programming language announced the new 1.22 release this Tuesday! Here’s the new features and how to install guide for Ubuntu & other Linux.

What’s New in Go 1.22:

  • The variables declared by a “for” loop were created once and updated by each iteration. In new 1.22 release, each iteration of the loop creates new variables, to avoid accidental sharing bugs.
  • “For” loops may now range over integers.
  • Commands in workspaces can now use a vendor directory containing the dependencies of the workspace.
  • go get is no longer supported outside of a module in the legacy GOPATH mode
  • 2% ~ 14% improvement from enabling PGO.
  • Requires the final point release of Go 1.20 or later for bootstrap
  • New math/rand/v2 package
  • New go/version package
  • See release note for more details.

How to Install Golang 1.22 in Ubuntu

1. Download the Linux Tarball

Go provides official Linux tarball for i386, amd64, arm64, and armv6l CPU architecture types. They are available to download at the link below:

In case you don’t know your system architecture type, press Ctrl+Alt+T to open terminal and run dpkg --print-architecture command to tell.

Or, run command to download the Linux tarball from command line (amd64 package in the case):

wget -c https://go.dev/dl/go1.22.0.linux-amd64.tar.gz

Golang keeps moving! When you see this tutorial, a newer release may be out. So, change the URL (usually the part of version number) in last command accordingly.

2. Extract Go Tarball to /usr/local

After downloaded the tarball, open terminal (Ctrl+Alt+T), and run commands:

  • Navigate to the folder that saved the tarball (usually Downloads):
    cd ~/Downloads
  • Then, extract the tarball to /usr/local directory:
    sudo tar -C /usr/local/ -xzf go1.22.0.linux-amd64.tar.gz

    Also replace package name go1.22.0.linux-amd64.tar.gz in the command according to which tarball you downloaded.

After successfully extracted the tarball, use ls /usr/local to verify. It will output a list of sub-folders including go.

3. Set PATH Environment Variable

a.) Add GOROOT to Your User PATH

To let your Ubuntu system know where to find Go command, user can add it to the PATH. And, here /usr/local/go is the GOROOT directory. You just need to add its bin sub-folder to the PATH.

Without logging out, run the command below to set PATH environment, which works until your close the terminal window or exit the command console.

export PATH=$PATH:/usr/local/go/bin

To make it permanent, open home folder, press Ctrl+H, then click edit the .profile file (or .bashrc). When file opens, add following lines and save it.

# set PATH so it includes /usr/local/go/bin if it exists
if [ -d "/usr/local/go/bin" ] ; then
    PATH="/usr/local/go/bin:$PATH"
fi

This works for current user only, and applies in next login.

To set the PATH environment variable for all users, create & edit a config file under /etc/profile.d directory instead. To do so, run command:

sudo nano /etc/profile.d/go.sh

Then, paste the same lines above. Press Ctrl+S to save, and Ctrl+X to exit. Also, log out and back in to apply.

b.) Add GOPATH to Your User PATH

Running go install command by default downloads & installs packages to go sub-folder (create automatically if not exist) in user home. It’s called GOPATH.

If you want to change GOPATH to another directory, for example .local/go, either use command below that works for current terminal or current command console:

export GOPATH=$HOME/.local/go

Or, edit the .profile file in user home and add it in the end to make it permanent at next login.

To add GOPATH to your user PATH, here use the default GOPATH for example, either run command for current command console only:

export PATH=$PATH:$HOME/go/bin

Or, edit the .profile file and add following lines:

# Add GOPATH to PATH if it exists
if [ -d "$HOME/go/bin" ] ; then
    PATH="$HOME/go/bin:$PATH"
fi

NOTE: The GOPATH directory may NOT exist out-of-the-box. You need to log out and back in to apply it to user PATH on the folder creation (usually first time running go install command).

Golang also has many other environment options, you may run go env command to print theme, and run similar commands above to change the directories.

Create your First Go program

When done setting PATH Environment Variable, you can run command to verify go version:

go version

To create your first Go project, create new file hello.go either in file manager or by using the command below:

nano hello.go

Then, add following lines and save it (For nano, press Ctrl+S then Ctrl+X):

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

Then, either use go run hello.go command to run it. Or go build hello.go to build into a binary file.

Uninstall Go

To uninstall golang, simply delete the go directory under /usr/local by running command:

sudo rm -R /usr/local/go

That’s it.

Twitter

I'm a freelance blogger who started using Ubuntu in 2007 and wishes to share my experiences and some useful tips with Ubuntu beginners and lovers. Please comment to let me know if the tutorial is outdated! And, notify me if you find any typo/grammar/language mistakes. English is not my native language. Contact me via [email protected] Buy me a coffee: https://ko-fi.com/ubuntuhandbook1

2 responses to How to Install GO (golang 1.22) in Ubuntu 22.04

  1. Thanks : this howto helped me build an add-on for LibreELEC with Ubuntu 22.04.

  2. However, when installing any package, let’s say “go install github.com/a-h/templ/cmd/templ@latest” the package will be installed in ~/go/bin … and it’s command “templ” will not be recognized at all since it is not part of the $PATH. This will keep most new users away.

Leave a Reply

Text formatting is available via select HTML.

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong> 

*