Instalar Go desde go.dev en Ubuntu

Instalar Go en Ubuntu desde go.dev

Instalación de Go utilizando el paquete oficial descargado directamente desde go.dev, sin utilizar el paquete de Go proporcionado por Ubuntu.

Método utilizado: instalación oficial de Go mediante el archivo .tar.gz. Este procedimiento es especialmente útil cuando necesitamos una versión de Go más reciente que la disponible en los repositorios de Ubuntu.

1. Comprobar la versión actual de Go

Antes de realizar cambios, podemos comprobar si Go ya está instalado:

go version

Por ejemplo:

go version go1.22.2 linux/amd64

También podemos comprobar dónde está instalado:

which go

Si fue instalado mediante los paquetes de Ubuntu, podemos encontrar algo similar a:

/usr/bin/go

2. Comprobar la versión disponible mediante APT

Ubuntu puede proporcionar una versión de Go más antigua que la disponible oficialmente en go.dev.

Podemos comprobar qué versión proporciona APT:

apt policy golang-go

Por ejemplo:

golang-go:
  Instalados: 2:1.22~2build1
  Candidato:  2:1.22~2build1

Importante: si necesitamos Go 1.25 y Ubuntu solamente ofrece Go 1.22 mediante APT, podemos instalar Go directamente desde go.dev.

3. Desinstalar la versión instalada mediante APT

Si ya tenemos Go instalado mediante Ubuntu, podemos eliminar ese paquete:

sudo apt remove golang-go

Esto elimina la instalación proporcionada por APT. No elimina nuestros proyectos escritos en Go.

4. Descargar Go desde go.dev

Las versiones oficiales de Go están disponibles en la página de descargas:

https://go.dev/dl/

Para un sistema Ubuntu de 64 bits con procesador AMD/Intel necesitamos la versión Linux AMD64.

Por ejemplo, para Go 1.25.4:

cd /tmp

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

Consejo: antes de instalar, podés entrar en go.dev/dl/ y comprobar cuál es la versión estable que querés utilizar.

5. Eliminar una instalación anterior

La instalación oficial utiliza:

/usr/local/go

Si existe una instalación anterior en esa ubicación, la eliminamos:

sudo rm -rf /usr/local/go

Importante: no debemos extraer una nueva versión encima de una instalación existente de /usr/local/go. La documentación oficial de Go advierte que esto puede producir una instalación dañada.

6. Instalar Go

Extraemos el archivo descargado dentro de /usr/local:

sudo tar -C /usr/local -xzf go1.25.4.linux-amd64.tar.gz

Ahora tendremos:

/usr/local/
└── go/
    ├── bin/
    ├── src/
    ├── pkg/
    └── ...

La documentación oficial de Go utiliza precisamente esta ubicación para la instalación manual en Linux. :contentReference[oaicite:0]{index=0}

7. Agregar Go al PATH

Necesitamos agregar el directorio de ejecutables de Go al PATH:

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc

Aplicamos el cambio inmediatamente:

source ~/.bashrc

También podemos cerrar y volver a abrir la terminal.

¿Por qué hacemos esto? Porque el ejecutable go está ubicado en /usr/local/go/bin y queremos poder ejecutar go desde cualquier directorio.

8. Comprobar la instalación

Ejecutamos:

go version

Deberíamos obtener algo similar a:

go version go1.25.4 linux/amd64

Comprobamos además qué ejecutable estamos utilizando:

which go

Ahora debería aparecer:

/usr/local/go/bin/go

9. Comprobar GOROOT

Podemos comprobar dónde está instalada la distribución de Go:

go env GOROOT

Resultado esperado:

/usr/local/go

10. Comprobar GOPATH

Go también dispone de un directorio para los proyectos y herramientas instaladas por el usuario:

go env GOPATH

Normalmente será:

/home/hugo/go

Este directorio es diferente de GOROOT.

Variable	Ejemplo	Función
GOROOT	/usr/local/go	Instalación de Go
GOPATH	/home/hugo/go	Espacio de trabajo del usuario

11. Agregar las herramientas de GOPATH al PATH

La documentación oficial también recomienda agregar $HOME/go/bin al PATH para poder utilizar herramientas instaladas mediante go install. :contentReference[oaicite:1]{index=1}

echo 'export PATH="$PATH:$(go env GOPATH)/bin"' >> ~/.bashrc

Aplicamos el cambio:

source ~/.bashrc

12. Verificación final

Podemos ejecutar todas estas comprobaciones:

go version
which go
go env GOROOT
go env GOPATH

Un resultado esperado sería:

go version go1.25.4 linux/amd64

/usr/local/go/bin/go

/usr/local/go

/home/hugo/go

Go instalado correctamente. Ahora tenemos Go instalado directamente desde la distribución oficial de go.dev, sin depender de la versión disponible en los repositorios de Ubuntu.

13. ¿Por qué utilizar este método?

Método	Ventaja
APT	Instalación sencilla e integrada con Ubuntu
go.dev	Permite utilizar versiones recientes de Go
Docker	Permite aislar la versión de Go dentro del contenedor

14. Utilizar Go para compilar GWMS

Una vez instalado Go 1.25, podemos clonar el proyecto:

cd /home/docker/gwms

git clone https://github.com/gdbrns/go-whatsapp-multi-session-rest-api.git source

Entramos al proyecto:

cd source

Descargamos las dependencias:

go mod download

Y podemos compilarlo:

go build -o whatsapp-api cmd/main/main.go

Esto genera:

whatsapp-api

Finalmente podemos ejecutarlo:

./whatsapp-api

En este punto tenemos dos posibilidades: ejecutar GWMS directamente en Ubuntu utilizando Go instalado desde go.dev, o construir una imagen Docker y ejecutar solamente el binario dentro del contenedor.

15. Resumen

              go.dev
                 │
                 ▼
       go1.25.4.linux-amd64.tar.gz
                 │
                 ▼
          /usr/local/go
                 │
                 ▼
        /usr/local/go/bin
                 │
                 ▼
              go 1.25
                 │
                 ▼
       Compilar aplicaciones Go
                 │
                 ▼
              GWMS

La instalación oficial de Go para Linux consiste básicamente en descargar el archivo desde go.dev, extraerlo en /usr/local, agregar /usr/local/go/bin al PATH y verificar con go version. :contentReference[oaicite:2]{index=2}