Skip to content
Studio 3T - The professional GUI, IDE and client for MongoDB
  • Tools
    • Aggregation Editor
    • IntelliShell
    • Visual Query Builder
    • Export Wizard
    • Import Wizard
    • Query Code
    • SQL Query
    • Connect
    • Schema Explorer
    • Compare
    • SQL ⇔ MongoDB Migration
    • Data Masking
    • Task Scheduler
    • Reschema
    • More Tools and Features
  • Solutions
  • Resources
    • Knowledge Base
    • MongoDB Tutorials & Courses
    • Tool/Feature Documentation
    • Reports
    • Case Studies
    • Whitepapers
    • Blog
    • Testimonials
    • Community
  • Contact us
    • Contact
    • Sales Support
    • Feedback and Support
    • Career
    • About Us
  • Store
    • Buy Now
    • Preferred Resellers
    • Team Pricing
  • My License
  • Download
search

Studio 3T Knowledge Base

  • Documentation
  • Tutorials
  • Workshops
Take the fastest route to learning MongoDB. Cover the basics in two hours with MongoDB 101, no registration required.
Start the free course

How to Install Studio 3T

Posted on: 14/09/2020 (last updated: 14/10/2021) by Kathryn Vargas

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.

Here’s how you can set up MongoDB on Windows via PowerShell.

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 cloud-hosted DBaaS providers. Check our our guides on how to connect to MongoDB Atlas, Compose, mLab, ScaleGrid, and ObjectRocket.  

Install Studio 3T

Studio 3T for Windows

Studio 3T is available for Windows 64-bit systems, with the bundled shell.

An .msi installer for 64-bit systems is also available for Studio 3T Ultimate users, also with 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 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-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

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.


How helpful was this article?
This article was hideous
This article was bad
This article was ok
This article was good
This article was great
Thank you for your feedback!

About The Author

Kathryn Vargas

When she's not writing about working with MongoDB, Kathryn spends her free time exploring Berlin's food scene, playing the drums, learning languages (current mission: German), and hiking.

Article navigation

Related articles

  • Windows 11: How to Install MongoDB with Studio 3T
  • 5 Reasons You Should Install A Local MongoDB Database
  • What’s New in Studio 3T 2020.10 | Data Masking, Reschema & The Fastest Studio 3T Version Yet
  • What’s New in Studio 3T – A NoSQL and MongoDB Blog
  • How to Increase Memory or Heap Size in Studio 3T

Studio 3T

MongoDB Enterprise Certified Technology PartnerSince 2014, 3T has been helping thousands of MongoDB developers and administrators with their everyday jobs by providing the finest MongoDB tools on the market. We guarantee the best compatibility with current and legacy releases of MongoDB, continue to deliver new features with every new software release, and provide high quality support.

Find us on FacebookFind us on TwitterFind us on YouTubeFind us on LinkedIn

Education

  • Free MongoDB Tutorials
  • Connect to MongoDB
  • Connect to MongoDB Atlas
  • Import Data to MongoDB
  • Export MongoDB Data
  • Build Aggregation Queries
  • Query MongoDB with SQL
  • Migrate from SQL to MongoDB

Resources

  • Feedback and Support
  • Sales Support
  • Knowledge Base
  • FAQ
  • Reports
  • Case Studies
  • White Papers
  • Testimonials
  • Discounts

Company

  • About Us
  • Blog
  • Careers
  • Legal
  • Press
  • Privacy Policy
  • EULA

© 2022 3T Software Labs GmbH. All rights reserved.

  • Privacy Policy
  • Cookie settings
  • Impressum
When you click "Accept", you are agreeing to cookies being on your device. They may improve site navigation, site usage analysis, or the relevance of messages. It is up to you which cookies are enabled. Read our Privacy Policy.
Manage cookies
Accept
✕

Privacy Preference Center

A cookie is a small file of letters and numbers that is downloaded on to your computer when you visit a website. Cookies are used by many websites and can do a number of things, eg remembering your preferences, recording what you have put in your shopping basket, and counting the number of people looking at a website. In the form below you can choose which cookies, except for essential cookies, to allow or disable.

Accept all cookies

Manage consent preferences

Essential cookies are strictly necessary to provide an online service such as our website or a service on our website which you have requested. The website or service will not work without them.

Performance cookies allow us to collect information such as number of visits and sources of traffic. This information is used in aggregate form to help us understand how our websites are being used, allowing us to improve both our website’s performance and your experience.

Functional cookies collect information about your preferences and choices and make using the website a lot easier and more relevant. Without these cookies, some of the site functionality may not work as intended.

Social media cookies are cookies used to share user behaviour information with a third-party social media platform. They may consequently effect how social media sites present you with information in the future.

Accept selected