Quick Install

Once you install TileDB, visit the Usage page to see how to use TileDB in your programs.

C / C++
Python
R
Go
Docker
C / C++
# Homebrew (macOS):
$ brew update
$ brew install tiledb-inc/stable/tiledb
# Or Conda (macOS, Linux, Windows):
$ conda install -c conda-forge tiledb
# Or download the pre-built release binaries from (Windows):
# https://github.com/TileDB-Inc/TileDB/releases
Python
# Pip:
$ pip install tiledb
# Or Conda:
$ conda install -c conda-forge tiledb-py

Conda will install pre-built TileDB-Py and TileDB core binaries for Windows, macOS, or Linux. Pip currently provides binary wheels for Linux, and will build all dependences from source on other platforms (see Building from Source for more information).

R
# install the 'remotes' package if needed
# install.packages("remotes")
library(remotes)
install_github("TileDB-Inc/TileDB-R", ref = github_release())
# verify install
library(tiledb)
tiledb::tiledb_version()
#> major minor patch
#> 1 7 5

TileDB needs to be installed beforehand (from a package or from source) for the TileDB-R package to build and link correctly. See Pre-built Packages for methods of installing TileDB.

Using TileDB From Custom Location

If the TileDB library is installed in a custom location, you need to pass the explicit path:

library(remotes)
install_github("TileDB-Inc/TileDB-R",
ref = github_release(),
args="--configure-args='--with-tiledb=/path/to/tiledb'")

Note on Installing with Conda

If you are using R inside conda and want to install TileDB-R you might run into a issue with devtools/remotes around gtar. The error is below:

Downloading GitHub repo TileDB-Inc/[email protected]
sh: 1: /bin/gtar: not found
sh: 1: /bin/gtar: not found
Error: Failed to install 'tiledb' from GitHub:

To fix this, simply export the TAR environmental variable before starting R

# Inside conda environment
TAR=`which tar` R
> # Follow instructions at start for installing TileDB-R
Go
# Go Get
$ go get -v github.com/TileDB-Inc/TileDB-Go
# Go modules
go mod init github.com/<github_username>/repository_name

Here is a sample go.mod file:

module github.com/<github_username>/repository_name
go 1.13
require (
github.com/TileDB-Inc/TileDB-Go v0.6.0
)

TileDB needs to be installed beforehand (from a package or from source) for the TileDB-Go library to build and link correctly.

Docker
$ docker pull tiledb/tiledb
$ docker run -it tiledb/tiledb