1. Install the core package

You can install other packages later, let’s start with a basic version for now:

npm install @hocuspocus/server

2. Start your server

The following example is the bare minimum you need to start a WebSocket server. By default, it’s listening on (or with the WebSocket protocol on ws://

import { Server } from '@hocuspocus/server'

const server = Server.configure({
  port: 80,


3. Connect with a frontend

Now, you’ll need to use Y.js in your frontend and connect to the server with the WebSocket provider. With Tiptap, our very own text editor, it’s also just a few lines of code.

That’s it. :)