Cloud Studio Installation MaxKB Tutorial#
Step-by-step tutorial series
I noticed that some people in the group always fail to deploy MaxKB and don't know the reason, so here is a step-by-step tutorial. If there are any mistakes, please forgive me. Let's get started! As usual, open the Cloud Studio official website and select the sDeepseekr14b template to start the machine. You might wonder why to choose 14b; it's because my available time is already over half, and I need to save some usage.
Wait a moment for resource allocation and booting. Since MaxKB uses port 8080, and the template we boot through by default occupies this port, we need to terminate the process occupying the port. In the terminal, input to check the process occupying the port:
lsof -i :8080
From the image, we can see that the current pid is 2323, so we use kill -9 pid to kill this process, which is kill -9 2323. This way, port 8080 will not be occupied. To ensure that the port can be used normally for the next boot, we also need to modify the configuration file .vscode/preview.yml and comment out the part for 8080.
For safety, my suggestion is to shut down and then boot again, but of course, you can do it differently if you prefer. Open the official link of MaxKB.
You will see the installation command:
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data -v ~/.python-packages:/opt/maxkb/app/sandbox/python-packages 1panel/maxkb
Here, two directories are actually needed: one is .maxkb, and the other is .python-packages. Note that the directories have a . in front. As shown in the image, click on the blank area and then click to create a new directory.
Enter the directory name .maxkb, and using the same method, we create the .python-packages directory.
After creating them, check if they are consistent.
The exciting moment has arrived; run the installation command in the terminal.
docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data -v ~/.python-packages:/opt/maxkb/app/sandbox/python-packages 1panel/maxkb
Installation successful.
As usual, click on the port, then click the small globe icon on the right side of 8080 to start witnessing the miracle.
Enter the username and password, and click login:
username: admin
password: MaxKB@123..
Enter the MaxKB system, reset the password, though you can choose not to reset it.
At this point, MaxKB has been successfully set up.
How to use it is beyond the scope of this tutorial. See you next time.