Try Studio 3T for Free

How to Install Studio 3T

If you’re looking for a MongoDB GUI, client, or IDE, we’re happy you’ve found Studio 3T.

Prerequisites

MongoDB for Windows

Install the latest MongoDB community edition on your Windows machine following these steps.

MongoDB for macOS

Follow MongoDB’s tutorial to install MongoDB on OSX through either the MongoDB Download Center or Homebrew.

In case you get a Permission denied error after trying to run mkdir -p /data/db, run the following command to make sure the /data/db directory has the right permissions:

sudo chown -R `id -un` /data/db
# Enter your password

MongoDB for Linux

MongoDB provides various packages for popular Linux distributions. View the full list here.

Alternatively, you can sign up for a MongoDB instance through third-party DBaaS providers. Check our our guides on how to connect to Compose, mLab, and ObjectRocket.  

Install Studio 3T

Studio 3T for Windows

Studio 3T is available for Windows 64- and 32-bit systems, with or without a bundled shell.

An .msi installer for 64-bit systems is also available for Studio 3T Enterprise users, also with or without the bundled shell.

  1. Download the latest Studio 3T version.
  2. Start the installer by opening the file.
  3. Follow the directions on the screen.


Click on More download options to find the appropriate installer for your machine. 

Studio 3T for Mac

OS X users can download Studio 3T with or without the bundled shell.

  1. Download the latest Studio 3T .dmg file.
  2. Open the .dmg file on your machine.
  3. Drag and drop the Studio 3T .app file into your Applications folder when prompted.

Studio 3T for Linux (e.g. Ubuntu, Debian)

Studio 3T is available for 64- and 32-bit Linux systems.

It is distributed as a gzipped tarball (.tar.gz), which can be unpacked at the command line or using system utilities such as Archive Manager.

The tarball contains a runnable .sh file that launches the installer for Studio 3T. Using this, you can install Studio 3T to your desired location and create a desktop shortcut to launch Studio 3T.

We support and test against the latest Ubuntu LTS version. Customers have also reported success with other Linux distributions, which you can feel free to evaluate during the free 30-day trial.

For example, to install from the command line:

  1. Open your shell.
  2. cd to the directory where the gzipped tarball (.tar.gz) was downloaded.
  3. Unpack and run the Studio 3T installer.

For the 64-bit version of Studio 3T:

$ tar -xvzf studio-3t-linux-x64.tar.gz
$ sh ./studio-3t-linux-x64.sh

For the 32-bit version of Studio 3T:

$ tar -xvzf studio-3t-linux-x86.tar.gz
$ sh ./studio-3t-linux-x86.sh

Make sure to have the following libraries installed:

  • libswt-gtk-4919.so
  • libswt-pi-gtk-4919.so
  • libswt-pi3-gtk-4919.so
  • libgtk-3.so

You don’t need the sh command if the file has sh extension.

Simply run the following command (and adjust accordingly for 64-bit):

$ tar -xvzf studio-3t-linux-x86.tar.gz
$ ./studio-3t-linux-x86.sh

Running Studio 3T on CentOS

When trying to run Studio 3T on CentOS, you may experience the following issue:

java: cairo-misc.c:380: _cairo_operator_bounded_by_source: Assertion `NOT_REACHED' failed.
./mongochef.sh: line 11: 28030 Aborted (core dumped) $DIR/../jre/bin/java -jar $DIR/../lib/data-man-mongodb-pro-*.jar

This is a general issue for all SWT-based applications on CentOS and is related to the Cairo 2D graphics library on CentOS.

The work-around is to pass ‘-Dorg.eclipse.swt.internal.gtk.cairoGraphics=false‘ to the application. In order to do that, open mongochef.sh in the bin directory of your Studio 3T installation and add the (highlighted) parameter to the last line of the script.

#!/bin/bash

SOURCE=”${BASH_SOURCE[0]}”
while [ -h “$SOURCE” ]; do # resolve $SOURCE until the file is no longer a symlink
DIR=”$( cd -P “$( dirname “$SOURCE” )” && pwd )”
SOURCE=”$(readlink “$SOURCE”)”
[[ $SOURCE != /* ]] && SOURCE=”$DIR/$SOURCE” # if $SOURCE was a relative symlink, we need to resolve it relative to the path where the symlink file was located
done
DIR=”$( cd -P “$( dirname “$SOURCE” )” && pwd )”

$DIR/../jre/bin/java -Dorg.eclipse.swt.internal.gtk.cairoGraphics=false -jar $DIR/../lib/data-man-mongodb-pro-*.jar

Save your script and you are good to go.

Now that you’re done with installation, read the Getting Started with Studio 3T guide to navigate the tool like a pro in no time.

Alternatively, check out our Getting Started with MongoDB guide for a comprehensive introduction to the most popular NoSQL database.

Updated on February 18, 2020

Was this article helpful?

Related Articles

Comments

    1. Hello!

      Thanks for writing to us. You’ll find the uninstall directions here: https://studio3t.com/download/. Be sure to select the appropriate OS and then go to the section called ‘How to install or uninstall Studio 3T’, just below the download button.

      Thanks for giving us a try,
      Dakota

  1. studio 3T not support mongodb 2.6.5 version. I can not use it.

  2. How to you deactivate the license used in Studio3T, to use for another user?

    1. Hi Mark!

      To answer your question, you can reassign each seat to a new user once a month. Specifically, this is what our EULA has to say on the subject:
      “[… ]You agree to have the SOFTWARE used […] by the agreed-upon number of all users identifiable on demand. Every user can be replaced by another user only once in a month. From that time on, said first user must not use the SOFTWARE anymore and said second user may start using the SOFTWARE. At no time must the number of known users exceed the number of the acquired licenses (example: If you have bought the SOFTWARE for three users who you can identify on demand, only those three users may use the SOFTWARE. This is true independently of the number and location of the respective installations of the SOFTWARE). ”
      For convenience, there is no special process involved.

    1. Hello!

      We recommend you try to invoke the Studio 3T installer in the command line with the -q flag. However, this will only work for Linux and Windows, given that Mac doesn’t have a dedicated installer.

  3. I am trying to install on LXMint 19 but when I run the sh installer I get a window popup with a titlebar but just white content, no text/buttons etc, even when I try to close this installer dialog I am presented with another small dialog (assuming its the cancellation prompt dialog) but also no buttons/text.

    I am unsure if there is a dependency for non-proxied access for your installer, but if so, please advise how one may configure proxy parameters to the installer if this is indeed the case.

    Thanks!

  4. Hi Julien,

    Many thanks for reaching out here. My colleague from the Support team will be in touch with you shortly.

    Best,
    Kathryn

  5. I got (failed to load module “canberra-gtk-module” right after. Did i fixed this after sudo apt-get update?

    1. Hi Martine,

      It looks like this error message pops up when you don’t have that library installed. To install, try sudo apt install libcanberra-gtk-module . If that doesn’t work, please provide more info through this form and we’d be happy to investigate further.

      Best,
      Kathryn

Leave a Comment