For a while now I’ve been running an Excalidraw instance on my VPS (with Yunohost). Excalidraw is a virtual whiteboard, and a useful tool to me. Excalidraw is lightweight, and any drawings you make are stored in text format, which makes them highly portable. It integrates very well with Obsidian, with the Excalidraw plugin, by fellow PKM enthusiast Zsolt Viczián. My Excalidraw instance is also used by my company’s team.

I run my own Excalidraw instance for reasons of digital autonomy. For single person use it provides that. However, Excalidraw has a collaboration mode, reserved to Excalidraw.com only (as noted in the package description), which depends on two outside parties with control over it. For my company collaboration mode is the primary desired use form, but it must be digitally autonomous to be of actual value. It should also actually work, which it doesn’t on a self-hosted instance.

In Excalidraw’s collaboration mode multiple users can work on its canvas (dubbed a ‘room’), where you see each-others edits in real time. Drawings you’ve made collaboratively also have a unique URL so the room can be called back up later, to continue work.

The Excalidraw.com deployment’s open source package, included in the general excalidraw package (which the Yunohost install package uses directly) has two things hardcoded that are needed for collaboration and persistence:

  • To make the realtime movement of cursors and edits visible, it calls the oss-collab.excalidraw.com subdomain for websocket connections but only answers requests with excalidraw.com as origin, and returns forbidden for my and other domains. In the browser, wss://oss-collab.excalidraw.com/socket.io/?EIO=4&transport=websocket fails. So it refuses self-hosted Excalidraw instances. The live view of other users and their edits therefore does not work on self-hosted instances.
  • It stores drawn objects in Firebase for persistence of rooms, and does so encrypted. For self-hosted instances this does work, reloading a room from storage shows the objects others made. However Excalidraw.com controls that storage, and holds the keys to it, meaning they can delete your stored material or remove your access at will. An issue of digital autonomy. Firebase itself is provided by Google, and while the Excalidraw objects are encrypted, it introduces another party with a hold on the data.

In practice, it means that a self-hosted instance of Excalidraw has a half working collaboration capability (no live sync, but reloading the persistent Firebase version works). It of course wasn’t promised to work, but even if it did it would not actually be an autonomous install due to the hardcoded dependencies. To gain that digital autonomy, and have functioning collaborative functionality, both a necessity for my team, I’d need to ‘bring home’ those dependencies.

The live collaboration part is created with the open source excalidraw-room script, which is easy enough to install on my VPS. Local storage may be more difficult to figure out (but not too hard, I hope). The main thing is that to let the excalidraw package talk to that room script and the storage, I need to alter that package itself. If the dependencies had been configurable settings it would be a different thing.
Now it needs a fork from Excalidraw, to be able to change those hard coded settings to provide both excalidraw-room and storage on my VPS itself. I do not look forward to maintaining a fork in order to change 3 things or so for the live collaboration to work (more to swap out storage), and then needing to keep it aligned with the upstream version of Excalidraw, but it seems to be the only viable path.

Whether there are other open source packages out there where self-hosting also carries hard coded cloud dependencies is a question I need to also stay aware of, I think.

Working on a visual representation of the European data strategy landscape, integrated as well as alongside a textual representation this morning. It makes for a pleasant experience. The experience comes from what Zsolt Viczián’s Excalidraw plugin for Obsidian allows me to do, something I mentioned here earlier after the PKM Summit last March where Zsolt showed this.

Excalidraw drawings are basically text files describing the drawing, which are then rendered in the viewer. What the plugin supports is putting other text elements outside the drawing elements, and exclude them from the visual view. This creates two representations of the same file: one the drawing presented visually, one the text content outside the visual. Zsolt calls it the ‘flip side’ of a drawing, being a note accompanying the drawing. I see it more like two different views on the same thing. I have a hotkey (cmd arrow down) enabled to flip a note between both views.

Putting both views next to each other, and working in both at the same time, allows me a seamless mode of working, switching between visual material and text writing. As shown in the screenshot below.

Here you see the same note twice, opened in two tabs. The left side is the textual representation. It also contains an embedded auto-generated image from the visual representation but that is something I choose to do. Underneath that image you see some notes I wrote.
The right hand side shows the visual representation, a drawing of how I perceive the context of the European single market for data (at least, part of it).
I use the visual side as a Systems Convening landscape, to think about barriers, possible interventions, visibility etc. I use the text side to turn those thoughts into notes, potential actions, and links to other relevant material, or to write down things I think might be added to the visual.

Over the years my main problem with working more visually has been the lack of fluidity between the visual and the textual. Basically rendering them into two separate silos. Few tools solve that issue (Tinderbox is one). This means I usually favor the textual side of things. Where I use images, they are ‘frozen’ moments of the ever evolving textual side. The set-up this morning is not silo’d and here the creation of visual elements aids the text creation and vice versa, while I work on both in parallel in a single note. Both text and visual evolve together. Very nice.

Favorited Sketch noting for PKM by Zsolt Viczián

Multiple elegant ideas (and practices) in that post, about the use of Excalidraw within Obsidian (which I previously described):
1) creating icons from basic forms (such as sketch noting teaches as well) and iterate each time you use them
2) keep your icons in a library in Excalidraw for various forms of re-use and for iteration
3) add #keywords to your icon, because in Excalidraw/Obsidian these behave as active searches for those keywords just like regular # in a text.

I came across this post by Zsolt Viczián through a list of PKM system examples by Elizabeth Butler, in which she also linked to my PKM description. Naturally I explored the other examples in that list, and this one stood out for me.

Because I couldn’t even get past the level of drawing stick figures, I have always felt intimidated by friends who could draw well. The idea of developing my visual vocabulary was a game-changer for me…… I added hashtags to each icon because, this way, if you add them to your sketch in the Obsidian-Excalidraw plugin, your drawing will be tagged with the relevant keywords.

Zsolt Viczián

Last week at the 3rd Dutch language Obsidian meet-up one of the participants showed Excalidraw. This is a browser based sketching tool, that was created early last year (so about as old as Obsidian itself). There is an Obsidian plugin for it, which I first assumed would allow you to embed images made in the browser tool, but I was wrong.

  • The plugin allows you to create sketches with Excalidraw inside Obsidian. Using command+P and typing create, you can select to create a sketch in various ways
  • The sketching is done inside an Obsidian pane
  • You can link text in a sketch to any other note simply by adding a markdown style link [[note name]]
  • You can even embed another note in the sketch by adding the markdown, using ![[note name]]

The files with the sketches are saved inside your Obsidian vault. I took a look in one of the files, and they are JSON descriptions of the sketches. They’re not images, they’re text descriptions and as such small flat text files just like the notes themselves.

I’m impressed. I could even see myself sketchnoting on a tablet right in Obsidian with this.


Exalidraw living inside an Obsidian note, through a plugin. I made a basic sketch, with a link to a note at the red pin.


Opening a sketch in a text editor shows it to be JSON