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 I'm creating 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 instance. You might wonder why to choose 14b; it's because my available time is already more than half used, and I need to save some.
Wait a moment for resource allocation and instance startup. Since MaxKB uses port 8080, and the instance started through the template will occupy this port by default, we need to terminate the process occupying the port. In the terminal, 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 next time we start the instance, we also need to modify the configuration file .vscode/preview.yml and comment out the part for port 8080.
To be safe, my suggestion is to shut down and then start up again, but if you don't want to do it this way, that's fine too. 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, you actually need two directories, 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, 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 of 8080 to start witnessing the miracle.
Enter the username and password, then 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.