Beekeeper Studio (Community Edition)
Beekeeper Studio is a cross-platform SQL editor and database manager available for Linux, Mac, and Windows. Beekeeper Studio Community Edition is GPL licensed so it is free (libre) and free (gratis).
How to install Beekeeper Studio
- Download the full version from the Beekeeper Studio website
- Download the community edition from the releases page
We publish binaries for MacOS, Windows, and Linux.
👉 Love Beekeeper Studio? Leave us a testimonial!
Editions of Beekeeper Studio
Beekeeper Studio - The full version of Beekeeper Studio with all features. Buying Beekeeper Studio is also the best way to support the community edition. Download from our website
Beekeeper Studio Community Edition - This repository. This is the open source version of Beekeeper Studio. It is a full featured database management client that is totally free and open source. Download from the releases page
Beekeeper Studio Features
Top feature: It's smooth 🍫, fast 🏎, and you'll actually enjoy using it 🥰
- Truly cross-platform: Windows, MacOS, and Linux
- Autocomplete SQL query editor with syntax highlighting
- Tabbed interface, so you can multitask
- Sort and filter table data to find just what you need
- Sensible keyboard-shortcuts
- Save queries for later
- Query run-history, so you can find that one query you got working 3 days ago
- Default dark theme
Features exclusive to the full commercial edition (available on our website):
- More themes
- Online storage for queries and connections with Workspaces
- Easy data formatting with Query magics
- Multi-table export (v4+)
- Easy database backup using native tools (v4+)
- Easy database restore using native tools (coming soon)
- Oracle Database support
- Cassandra database support
One of our frustrations with other open-source SQL editors and database managers is that they take a 'kitchen sink' approach to features, adding so many features that the UI becomes cluttered and hard to navigate. We wanted a good looking, open source SQL workbench that's powerful, but also easy to use. We couldn't find one, so we created Beekeeper Studio!
Beekeeper Studio supports connecting to the following databases:
- SQL Server
- Amazon Redshift
The commercial version of Beekeeper Studio (avaliable here) also supports:
- Oracle Database
- Cassandra Database
Supporting Beekeeper Studio
I love working on Beekeeper Studio, and I'd love to keep growing and improving it forever. To do that I need your help.
The best way to support Beekeeper Studio is to purchase the Ultimate Edition. Every purchase directly supports my work on Beekeeper Studio.
If you can't afford a license, please consider becoming a project sponsor.
Thank you for your continued support!
Check out docs.beekeeperstudio.io for user guides, FAQs, troubleshooting tips, and more.
Beekeeper Studio Community Edition (the code in this repository) is licensed under the GPLv3 license.
Beekeeper Studio Ultimate Edition contains extra features and is licensed under a commercial end user agreement (EULA).
Beekeeper Studio's trademarks (words marks and logos) are not open source. See our trademark guidelines for more information.
Trademarks can be complicated with open source projects, so we have adapted a set of standard guidelines for using our trademarks that are common to many open source projects.
If you are just using the Beekeeper Studio app, and you are not forking or distributing Beekeeper Studio code in any way, these probably don't apply to you.
Contributing to Beekeeper Studio
We love any community engagement. Even if you're complaining because you don't like something about the app!
Building an inclusive and welcoming community is important to us, so please follow our code of conduct as you engage with the project.
By contributing to the project you agree to the terms of our contributor guidelines.
Contribute without coding
We have you covered, read our guide to contributing in 10 minutes without coding.
Compiling and Running Beekeeper Studio Locally
Want to write some code and improve Beekeeper Studio? Getting set-up is easy on Mac, Linux, or Windows.
# First: Install NodeJS 12 or 14, NPM, and Yarn # ... # 1. Fork the Beekeeper Studio Repo (click fork button at top right of this screen) # 2. Check out your fork: git clone firstname.lastname@example.org:<your-username>/beekeeper-studio.git beekeeper-studio cd beekeeper-studio/ yarn install # installs dependencies # if using Node 16.17+: export NODE_OPTIONS=--openssl-legacy-provider # Now you can start the app: yarn run electron:serve ## the app will now start
Where to make changes?
This repo is now a monorepo, we have several places with code, but only really a couple of important entry points.
All app code lives in
apps/studio, some shared code lives in
shared/src. This is shared with other apps.
Beekeeper Studio has two entry points:
background.js- this is the electron-side code that controls native things like showing windows.
main.js- this is the entry point for the Vue.js app. You can follow the Vue component breadcrumbs from
App.vueto find the screen you need.
Generally we have two 'screens':
- ConnectionInterface - connecting to a DB
- CoreInterface - interacting with a database
How to submit a change?
- Push your changes to your repository and open a Pull Request from our github page (this page)
- Make sure to write some notes about what your change does! A gif is always welcome for visual changes.
Maintainer notes (casual readers can ignore this stuff)
Upgrading Electron Gotchas
This is always a total pain and will break the build 9/10.
Some things you need to consider when upgrading Electron:
- Does it use a different node version. Eg Electron-18 uses node 14, 22 uses node 16. So everyone needs to upgrade
- Does node-abi need to be upgraded to be able to understand the electron version? This is used in the build to fetch prebuilt packages. You need to upgrade this in root/package.json#resolutions
- Were any APIs deprecated or removed? Make sure all features that interact with the Electron APIs still work, stuff like - selecting a file, maximizing a window, running a query, etc.
- Up the version number in package.json
build/release-notes.mdwith the latest release notes. Follow the format that is there.
git log <last-tag>..HEAD --oneline | grep 'Merge pull'to find PRs merged
- Push to master
- Create a tag
git tag v<version>. It must start with a 'v'
git push origin <tagname>
- Now wait for the build/publish action to complete on Github
- Push the new release live
- Go to the new 'draft' release on the releases tab of github, edit the notes, publish
- Log into snapcraft.io, drag the uploaded release into the 'stable' channel for each architecture.
This should also publish the latest docs
- Copy release notes to a blog post, post on website
- Tweet link
- Share on LinkedIn
- Send to mailing list on SendInBlue
Beekeeper Studio wouldn't exist without Sqlectron-core, the core database libraries from the Sqlectron project. Beekeeper Studio started as an experimental fork of that repository. A big thanks to @maxcnunes and the rest of the Sqlectron community.
The original license from sqlectron-core is included here:
Copyright (c) 2015 The SQLECTRON Team Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.