🚀 BlockAssist on Kasm — Setup Guide

Welcome to the BlockAssist setup guide! This walkthrough installs Kasm (optional), sets up Java + Python, and runs BlockAssist on the Kasm web desktop.

---

🧭 Prerequisites

• ✅ Ubuntu 22.04 or 24.04 (root or sudo)
• ✅ git and curl installed
• ✅ Browser access to your VM (for Kasm desktop)
• ✅ Kasm Workspaces (installed in Step 1)
• ✅ ~100 GB free disk space

---

⚙️ Setup Steps

📦 1.Install Kasm on your vps

git clone https://github.com/xailong-6969/blockassist-vps

cd kasmvnc
bash kasm-install.sh

• After installing kasm workspace, open in your browser:

• https://(your-vm-public-ip)(if routed)

• open the public ip on your local browser

• Credentials are printed and saved to ~/kasm_credentials.txt

• login with the admin details

🚀After login follow this steps:-

• ✅there will be a dashboard like this

• ✅Then click on workspaces

• ✅Add a workspace

• ✅Choose container then ubuntu jammy desktop

• Mention the cores and dont need to change the memory and gpu count

• ✅ To give the workspace full root access, find the Docker Run Config Override (JSON) field and paste this configuration:

{
  "hostname": "kasm",
  "user": "root"
}

• after performing all these steps open the ubuntu jammy desktop or if you selected ubuntu noble its fine too

• it will take sometime to install the workspace after installation move to workspaces section click on it

• Now open terminal and use this command to it full root access

sudo su -

• Then clone the repository again and perform the following steps

git clone https://github.com/xailong-6969/blockassist-vps

cd blockassist-setup.sh

bash blockassist-setup.sh