# Go MQTT with RabbitMQ and LavinMQ

We recommend [paho.mqtt.golang](https://github.com/eclipse-paho/paho.mqtt.golang), the Eclipse Paho MQTT client for Go.

```bash
go get github.com/eclipse/paho.mqtt.golang
```

## Publish and subscribe

Set `MQTT_HOST`, `MQTT_PORT`, `MQTT_USERNAME` and `MQTT_PASSWORD` to the MQTT details on your instance’s details page in the CloudAMQP console. Port 8883 uses TLS. Without them, the examples connect to a local broker.

Save the publisher as `publisher/main.go`:

```go
package main

import (
	"cmp"
	"fmt"
	"log"
	"os"

	mqtt "github.com/eclipse/paho.mqtt.golang"
)

func main() {
	scheme, port := "tcp", cmp.Or(os.Getenv("MQTT_PORT"), "1883")
	if port == "8883" {
		scheme = "ssl"
	}
	opts := mqtt.NewClientOptions().
		AddBroker(fmt.Sprintf("%s://%s:%s", scheme, cmp.Or(os.Getenv("MQTT_HOST"), "localhost"), port)).
		SetUsername(cmp.Or(os.Getenv("MQTT_USERNAME"), "guest")).
		SetPassword(cmp.Or(os.Getenv("MQTT_PASSWORD"), "guest"))
	client := mqtt.NewClient(opts)
	if token := client.Connect(); token.Wait() && token.Error() != nil {
		log.Fatal(token.Error())
	}
	defer client.Disconnect(250)

	// QoS 1 waits for the broker's PUBACK
	if token := client.Publish("hello", 1, false, "Hello world!"); token.Wait() && token.Error() != nil {
		log.Fatal(token.Error())
	}
	fmt.Println(" [x] Sent 'Hello world!'")
}
```

Save the subscriber as `worker/main.go`:

```go
package main

import (
	"cmp"
	"fmt"
	"log"
	"os"
	"os/signal"

	mqtt "github.com/eclipse/paho.mqtt.golang"
)

func main() {
	scheme, port := "tcp", cmp.Or(os.Getenv("MQTT_PORT"), "1883")
	if port == "8883" {
		scheme = "ssl"
	}
	opts := mqtt.NewClientOptions().
		AddBroker(fmt.Sprintf("%s://%s:%s", scheme, cmp.Or(os.Getenv("MQTT_HOST"), "localhost"), port)).
		SetUsername(cmp.Or(os.Getenv("MQTT_USERNAME"), "guest")).
		SetPassword(cmp.Or(os.Getenv("MQTT_PASSWORD"), "guest"))
	client := mqtt.NewClient(opts)
	if token := client.Connect(); token.Wait() && token.Error() != nil {
		log.Fatal(token.Error())
	}
	defer client.Disconnect(250)

	// Each message is acked when the handler returns
	token := client.Subscribe("hello", 1, func(_ mqtt.Client, msg mqtt.Message) {
		fmt.Printf(" [x] Received '%s'\n", msg.Payload())
	})
	if token.Wait() && token.Error() != nil {
		log.Fatal(token.Error())
	}
	fmt.Println(" [*] Waiting for messages. To exit press CTRL+C")

	interrupt := make(chan os.Signal, 1)
	signal.Notify(interrupt, os.Interrupt)
	<-interrupt
}
```

Run `go run ./worker` in one terminal and `go run ./publisher` in another.

A runnable example is in [go/paho-mqtt in cloudamqp/examples](https://github.com/cloudamqp/examples/tree/main/go/paho-mqtt).

## Good to know

- **Put the vhost in the username**, as `vhost:user`. MQTT has no vhost of its own, and the console shows the username that way.
- **Use `ssl://` for TLS**, as the examples do on port 8883. The server certificate is verified.
- **Use QoS 1**, so the publish token completes once the broker has sent its PUBACK, and each message is acked when the handler returns.
- **The client reconnects automatically**, but with a clean session the subscriptions are gone after a reconnect. Subscribe in a handler set with `SetOnConnectHandler` to subscribe again on every connect.
