> ## Documentation Index
> This page is part of the Image and Video APIs product. Fetch the complete documentation index for Image and Video APIs at: https://cloudinary.com/documentation/llms-image-and-video-apis.txt?referrer=docpage and then use it to discover all relevant pages before exploring further.
> If your task extends beyond this product, fetch the top-level index covering all Cloudinary products and topics at: https://cloudinary.com/documentation/llms.txt?referrer=docpage

# Configure the Go SDK (video tutorial)

## Overview

Learn how to install and configure the [Cloudinary Go SDK](go_integration) in your Go environment. This will enable you to utilize Cloudinary for uploading, managing, and displaying assets in your applications.

## Video tutorial

  This video is brought to you by Cloudinary's video player - embed your own!Use the controls to set the playback speed, navigate to chapters of interest and select subtitles in your preferred language.
{videoTranscript:publicId=training/go-configuration}

## Tutorial contents
This tutorial presents the following topics. Click a timestamp to jump to that part of the video.### Introduction
{table:class=tutorial-bullets}|  | 
| --- | --- |
| | The [Cloudinary Go SDK](go_integration) gives you a way to handle images and videos at scale, providing transformation, optimization and delivery capabilities that you can integrate seamlessly into your Go applications. 
|

### Install the Go SDK
{table:class=tutorial-bullets}|  | 
| --- | --- |
| | To install the Cloudinary Go SDK, ensure you're in the directory where your Go module was initialized using `go mod init`. Use the `go get` command to add the Cloudinary Go [library](https://github.com/cloudinary/cloudinary-go) from GitHub to your project.
|

```go
go get github.com/cloudinary/cloudinary-go/v2
```

### Configure Cloudinary
{table:class=tutorial-bullets}|  | 
| --- | --- |
| | To configure Cloudinary, begin by creating a Cloudinary instance. Import the Cloudinary library from GitHub and use the `cloudinary.New` function to create the instance. Store this instance in a variable, such as `cld`, and include error handling.
|

my_file.go

```go
import {
    "github.com/cloudinary/cloudinary-go/v2"
}

func main() {
    cld, err := cloudinary.New()
    if err != nil {
        log.Fatalf("failed to initialize Cloudinary client: %v", err)
    }
}
```
### Add credentials
{table:class=tutorial-bullets}|  | 
| --- | --- |
| | To keep your credentials secure:Store them in a `.env` file.Install the library with `go get github.com/joho/godotenv`.Import the `godotenv` library in your code.Use `godotenv.Load()` to load the credentials into your Go file.Retrieve your Cloudinary credentials from the [API Keys](https://console.cloudinary.com/app/settings/api-keys) page in the Cloudinary Console. Copy the provided **API environment variable** format (containing the **Cloud Name**, **API Key**, and **API Secret**) and paste it into your `.env` file, replacing the placeholder values with your actual credentials. 
|

```go
go get github.com/joho/godotenv
```

my_file.go

```go
import {
    "github.com/cloudinary/cloudinary-go/v2"
    "github.com/joho/godotenv"
}

func main() {
    err := godotenv.Load()
    if err != nil {
        log.Fatalf("Error loading .env file: %v", err)
    }
    cld, err := cloudinary.New()
    if err != nil {
        log.Fatalf("failed to initialize Cloudinary client: %v", err)
    }
}
```

### Retrieve an image delivery URL from Cloudinary
{table:class=tutorial-bullets}|  | 
| --- | --- |
| | With your Cloudinary instance configured, you can generate a delivery URL for an image in your product environment: Use the `cld.Image` function with the public ID of the desired image to create an image object. For this example, you can use the public ID of a sample image `cld-sample` provided with every new Cloudinary account. Store this object in a variable named `img` and handle any errors. Convert the image object to a string to generate the delivery URL. Include error handling and print the URL upon success.|

my_file.go

```go
import {
    "github.com/cloudinary/cloudinary-go/v2"
    "github.com/joho/godotenv"
}

func main() {
    err := godotenv.Load()
    if err != nil {
        log.Fatalf("Error loading .env file: %v", err)
    }
    cld, err := cloudinary.New()
    if err != nil {
        log.Fatalf("failed to initialize Cloudinary client: %v", err)
    }

    img, err :=cld.Image("cld-sample")
    if err !=nil {
        fmt.Println("error")
    }

    url, err := img.String()
    if err != nil {
        fmr.Pringln("error")
    } else {
        fmt.Println("Image URL: ", url)
    }
}
```

### Run the code
{table:class=tutorial-bullets}|  | 
| --- | --- |
| | After writing the code, run it to see the delivery URL for the `cld-sample` image. This confirms that your Cloudinary instance was successfully created and used. You can also open the URL in a browser to view the image in your product environment.
|

## Keep learning

> **READING**:
>
> * Learn more about the [Go SDK](go_integration).

> * Watch more [Dev Hints videos](https://www.youtube.com/playlist?list=PL8dVGjLA2oMpaTbvoKCaRNBMQzBUIv7N8) on the [Cloudinary YouTube channel](https://www.youtube.com/cloudinary).

#### If you like this, you might also like...

[Optimization Tips](optimization_tips_tutorial)

Tips for delivering optimized images

[Create Upload Presets (Node.js)](create_upload_preset_tutorial)

Streamline media uploads using signed upload presets

[Auto Upload](auto_upload_tutorial)

Automatically upload remote images and videos to Cloudinary

 

 Check out the Cloudinary Academy for free self-paced Cloudinary courses on a variety of developer or DAM topics, or register for formal instructor-led courses, either virtual or on-site.