Skip to main content
Version: v0.4

Quick Start


Walrus is alpha-quality software. It is under rapid development. Subsequent versions may introduce API changes that are not compatible.



  • A Linux server with no less than 4 CPU cores, 8GiB memory.
  • At least 50GB of free disk space.
  • Docker installed, if not please refer to the Docker official documentation.
  • Server ports 80 and 443 are open.

Execute the following command to start the Walrus service:

sudo docker run -d --privileged --restart=always -p 80:80 -p 443:443 --name walrus sealio/walrus:v0.4.0

For more detailed installation requirements, please refer to installation.

Access UI

  1. Access Walrus UI through https://<server-address>.

  2. Login to Walrus with the username admin and the initial administrator password, and set a new password and Walrus's access address as prompted by the UI.

Run the following command on the server to get the initial administrator password.

sudo docker logs walrus 2>&1 | grep "Bootstrap Admin Password"


Add a Kubernetes Cluster as Deployment Target


  • A Kubernetes cluster that can be reached by the Walrus server.
  1. Click the Application Management menu in the navigation bar to go to the default project view by default.
  2. Click the Connectors tab.
  3. Click the New Connector button, and select Kubernetes type.
  4. Fill in the cluster name and KubeConfig file, and click save.


Create Environment

  1. Click the Environment tab, and click the New Environment button.


  1. Enter the environment name, such as dev.
  2. Click Add Connector button, and select the Kubernetes connector added in the previous step.
  3. Click save.


Deploy Service

  1. In the environment list page, click the environment name created in the previous step to enter the environment view.


  1. Click the New button and select Service.


  1. Fill in the service name, such as myapp, and make sure the template is selected as kubernetes-containerservice.
  2. Enter nginx image in the Image Name of the template configuration, and click confirm.


  1. Click the Save and Deploy button to complete the creation of the service.
  2. After the service deployment is complete, you can view components, logs, execute terminal commands, access the address of this nginx service, etc.
  • View deployment logs.


  • View component logs.


  • Open terminal.


Congratulations, you have deployed your first application using Walrus!