Skip to content
This repository holds source code of Balsa, a self hosted, privacy focused knowledgebase.
Vue JavaScript TypeScript CSS HTML Shell Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.docker removed server port and now api is serving from same port Oct 24, 2019
tsconfig.json permission updates Oct 1, 2019

Balsa logo

Privacy and security focused knowledgebase and tasks management


Gitter License Version

forthebadge forthebadge forthebadge

Table of Contents


Balsa is an open source knowledge management platform that has an aim to meet the most demanding privacy and security standards. Balsa centralizes your company documents, helping you collaborate and get organized using a single, privacy-focusing service.

Balsa helps diversified, team-based organizations collaborate and share knowledge seamlessly and securely. It centralizes internal knowledge and workflow, without worrying about security and data privacy. With Balsa, you can get up and start collaborating quickly with the help of integrations and underlying robust, secure infrastructure.

Use Balsa to:

  • Empower your colleagues and help them document faster - with less email, and fewer meetings.
  • Connect people with company’s private knowledge in a trusted workplace
  • Customize, white label, and adopt according to your requirements

Balsa is “work processing” made simple and secure.


We realize you need a modern, fast, plugin based knowledge management platform that you can trust. Balsa centralizes your company documents, helping you collaborate and get organized using a single, privacy-focusing service.

  • 🚀 Knowledgebase & documents: Balsa has a company-wide knowledgebase that you can store and share your most important documents within the company, without sharing it with 3rd parties, using highest security standards.
  • 🔖 Tasks & projects: From simple listviews to tasks, Balsa provides you the simplest yet thought out solution your project teams across the company can use.
  • 📄 Tables (and soon spreadsheets): Keeping a list of your todo items, organizing your client list or just maintain your HR resources is a breeze with Balsa. Just start with a blank page, add collaborators and go.
  • 👥 Team management: Balsa has 2-level user management role system where you can define admins or users, each having different permissions.
  • ⚡️ Keep track of changes in the activity stream
  • 💬 Discuss with your team using comments
  • 🔍 Search in documents and preview all results in a simple manner


Balsa installer assumes it is running on a vanilla Ubuntu without any services listening on port 80 or 443 (which should also be open to incoming traffic). Once run, it takes care of every configuration and doesn't require any additional, manual intervention.

To deploy Balsa, download the latest release and run: sudo ./

We are going to add more Linux distributions (e.g CentOS and RHEL) in the very near future.


What we would like to add on top of Balsa are as follows:

Currently working on Near term features Long term features
Offline access Spreadsheet support A full fledged database
Emoji support Image annotations Edit/annotate images
Smart links preview Calendar support Search in PDFs
File lock & unlock Document history Search in images
Evernote importer Any file upload & storage Spell checker
Document anchors Bulk image upload Mobile apps for iOS/Android
Font & table bg colors Tip/warn/error/note extension
LDAP support for Enterprise Edition Web clipper
Confluence importer Gantt support
Plugin support Table of contents


Balsa is written using modern stacks, including Vue (with Element Vue UI framework), Nodejs, Apollo GraphQL and Postgresql. Our editor is Tiptap, a Vue wrapper on top of Prosemirror.




Security is critical to us. If you discover any issue regarding security, please disclose the information responsibly by sending an email to and not by creating a GitHub issue. We'll respond immediately.


Feel free to send us feedback on Twitter or file an issue. Feature requests are always welcome. If you wish to contribute, please take a quick look at the guidelines!

If there's anything you'd like to discuss, please feel free to join our forum. In case there is a feature you care about currently missing, make sure to browse the issue tracker and add your "👍" reaction to the issue(s) you care about. That way you will help us prioritize those ones.


Apache 2.0 with Commons Clause

You can’t perform that action at this time.