We host a public instance of webKnossos for trial purposes at https://try.webknossos.org. Visit the page and create your organization to get started. The trial is limited to 2 months of use. If you would like to continue using webKnossos, we offer managed hosting plans for uninterrupted service.
webKnossos is open-source, so you can install it on your own server. We recommend a server with at least 4 CPU cores, 16 GB RAM, and as much disk space as you require for your datasets. As prerequisites, you need to install Git, Docker and Docker Compose on your server.
To get started, simply clone the Git repository and start the docker containers:
git clone https://github.com/scalableminds/webknossos.gitcd webknossosdocker-compose pull webknossos./start-docker.sh
This will start an instance of webKnossos on http://localhost:9000/. Open the URL in your browser and configure your organization. This will create a folder for your data at
You may also install webKnossos without Docker. This may be useful if you intend to develop features for webKnossos. Please refer to the Code Readme for details.
When starting with webKnossos you first need to create an organization. An organization represents your lab in webKnossos and handles permissions for users and datasets. Choose a descriptive name for your organization, e.g. "The University of Springfield", "Simpsons Lab" or "Neuroscience Department".
In the onboarding flow, you are asked to create a user account for yourself. This will be the first user of your organization which will automatically be activated and granted admin rights. Make sure to enter a correct email address.
Now that you've completed the onboarding, you need to import a dataset. Without any data, webKnossos is not fun.
For small datasets (max. 1GB), you can use the upload functionality provide in the web interface. For larger datasets, we recommend the file system upload. Read more about the import functionality in the Datasets guide.
If you do not have a compatible dataset available, you can use one of the sample datasets for testing purposes.
By default, datasets are visible to all users in your organization. However, webKnossos includes fine-grained permissions to assign datasets to groups of users.
To get started with your first annotation, navigate to the
Datasets tab on your dashboard. Identify a dataset that your interested in and click on
Start Skeleton Tracing to create a new skeleton annotation. webKnossos will launch the main annotation screen allowing you to navigate your dataset and place markers to reconstruct skeletons.
Drag the mouse while pressing the left mouse button to navigate the dataset. Right-click in the data to place markers, called nodes. Basic movement in the dataset is done with the mouse wheel or by pressing the spacebar keyboard shortcut.
Learn more about the skeleton, volume, and hybrid annotations as well as the interface in the Tracing UI guide.
Now you know the basics of webKnossos. Feel free to explore more features of webKnossos in this documentation.
If you need help with webKnossos, there is a Community Support forum where members of the community and scalable minds are happy to answer your questions. scalable minds also offers commercial support, managed hosting and feature development services. Please contact us if you want to learn more.