Skip to main content
The Go SDK is currently in Public Preview with version 5.0.0-go-preview.3. If you encounter any issues or need assistance, please contact Ditto Support.
The Public Preview of the Ditto Go SDK can be used for exploratory development and prototypes. Refer to the documentation for supported features. Future versions of the Ditto Go SDK may not be compatible with the current preview API.

​
Adding the Ditto Go SDK to a Go Application

The Ditto Go SDK is available via a public GitHub repository: https://github.com/getditto/ditto-go-sdk/. In the directory containing your application’s go.mod file, run these commands to add the Ditto Go SDK and its dependencies: 
go get github.com/getditto/ditto-go-sdk/v5@latest
go mod tidy
Then, in any Go source file that uses the Ditto SDK, add this import for the ditto package: 
import "github.com/getditto/ditto-go-sdk/v5/ditto"
Go
const endpoint = "REPLACE_ME_WITH_YOUR_URL"
const id       = "REPLACE_ME_WITH_YOUR_DATABASE_ID"
const token    = "REPLACE_ME_WITH_YOUR_DEVELOPMENT_TOKEN"

config := ditto.DefaultDittoConfig().
    WithDatabaseID(id).
    WithConnect(&ditto.DittoConfigConnectServer{URL: endpoint})

dit, err := ditto.Open(config)
if err != nil {
    log.Fatalf("error: failed to open Ditto: %v", err)
}
defer dit.Close()

// Set up authentication expiration handler (required for server connections)
dit.Auth().SetExpirationHandler(
    func(d *ditto.Ditto, timeUntilExpiration time.Duration) {
        _, err := d.Auth().Login(token, ditto.DevelopmentAuthenticationProvider())
        if err != nil {
            log.Errorf("Authentication failed: %v", err)
        } else {
            log.Printf("Authentication succeeded")
        }
    })

if err := dit.Sync().Start(); err != nil {
    log.Errorf("error: failed to start sync: %v", err)
}
API documentation for the Go SDK can be found at https://software.ditto.live/go/Ditto/5.0.0-go-preview.3/docs/github.com/getditto/ditto-go-sdk/v5/ditto/index.html.

​
Installing the Ditto Go SDK Native Library

A native library provides Ditto Edge Sync Platform functionality, and must be linked into any application that uses the Ditto Go SDK.

​
Downloading and Unpacking the Ditto Library

Download Ditto.tar.gz and unpack an archive containing the libdittoffi.so (Linux) or libdittoffi.dylib (macOS) shared library: 
curl -O https://software.ditto.live/go/Ditto/5.0.0-go-preview.3/dist/libdittoffi-linux-x86_64.tar.gz && tar xvfz libdittoffi-linux-x86_64.tar.gz

​
Linking to the Ditto Shared Library at Build Time

When you build your application that uses the Ditto Go SDK, the linker needs to be able to find the native library.

​
Linux

The shared libdittoffi.so library will automatically be linked to by the Go SDK if it is in one of these locations:
  • /usr/local/lib
  • /usr/lib
Copy the unpacked libdittoffi.so to one of these locations for automatic linking. If your libdittoffi.so is located somewhere else, you can pass that path to go build via the -ldflags option when you build your application. 
go build -ldflags='-extldflags "-L/path/to/my/lib/directory"'

​
macOS

The shared libdittoffi.dylib library will automatically be linked to by the Go SDK if it is in one of these locations:
  • /usr/local/lib
  • /usr/lib
Copy the unpacked libdittoffi.dylib to one of these locations for automatic linking. If your libdittoffi.dylib is located somewhere else, you can pass that path to go build via the -ldflags option when you build your application. 
go build -ldflags='-extldflags "-L/path/to/my/lib/directory"'

​
Linking to the Ditto Shared Library at Run Time

When an app that uses the Ditto Go SDK is run, the system must be able to find and load the native library.

​
Linux

Ubuntu/Debian will search in these directories at runtime by default:
  • /lib
  • /lib64
  • /usr/lib
  • /usr/lib64
  • /usr/local/lib
If you don’t deploy the libdittoffi.so library in one of those directories, set the LD_LIBRARY_PATH environment variable to the appropriate directory when running your application. For example: 
LD_LIBRARY_PATH=/path/to/my/lib/directory ./myapp
or 
export LD_LIBRARY_PATH=/path/to/my/lib/directory
./myapp

​
macOS

macOS will search in these directories at runtime by default:
  • /usr/lib
  • /usr/local/lib
If you don’t deploy the libdittoffi.dylib library in one of those directories, set the DYLD_LIBRARY_PATH environment variable to the appropriate directory when running your application. For example: 
DYLD_LIBRARY_PATH=/path/to/my/lib/directory ./myapp
or 
export DYLD_LIBRARY_PATH=/path/to/my/lib/directory
./myapp