#ubuntu #vibe-kanban #vibe-coding #npm #npx #pm2

```table-of-contents
```

# 在Ubuntu 上安装Vibe-Kanban

## Git 项目
https://github.com/BloopAI/vibe-kanban

https://www.vibekanban.com/docs/getting-started
## Prerequisites

Before installing Vibe Kanban, ensure you have:

- **Node.js**: Latest LTS version recommended
- **Coding agent authentication**: Authenticate with your preferred coding agents outside of Vibe Kanban

## Safety Notice

Vibe Kanban runs AI agents with —dangerously-skip-permissions/—yolo flags by default so they can work autonomously without constant approval prompts. Each task runs in an isolated git worktree, preventing agents from interfering with each other. Agents can still perform system-level actions, so review their work and keep backups.

## Installation & Setup

### 1 Authenticate with a coding agent

Before launching Vibe Kanban, ensure you’re authenticated with at least one [supported coding agent](https://www.vibekanban.com/docs/supported-coding-agents). Follow the installation and authentication instructions for your preferred agent.

### 2 Install and launch Vibe Kanban

Open a terminal and run:

```
npx vibe-kanban
```

The application will bind to a random free port, print the URL in the terminal, and automatically open in your default browser.

### 3 Complete initial setup

Complete the setup dialogs to configure your coding agent and editor preferences. GitHub integration relies on the GitHub CLI and is configured when needed.

### 4 Create your first project

You’ll land on the Projects page, populated with your three most recently active git projects if automatically discovered. Click “Create project” to add more projects.

### 5 Add tasks

Start tracking your work by [creating tasks](https://www.vibekanban.com/docs/core-features/creating-tasks) within your project.

### 6 Optional: GitHub integration

Vibe Kanban uses the [GitHub CLI](https://cli.github.com/) for creating pull requests. Ensure `gh` is installed and authenticated on your system, or follow the setup prompts when creating your first pull request.

### 7 Optional: Set up MCP integration

Streamline task creation with coding agents by [setting up MCP integration](https://www.vibekanban.com/docs/integrations/vibe-kanban-mcp-server).

To use a fixed port, specify the `PORT` environment variable: `PORT=8080 npx vibe-kanban`


## 使用 PM2来管理Vibe-Kanban 进程

PM2 是一个进程管理器，非常适合管理像 `vibe-kanban` 这种基于 Node.js 的工具。它可以自动重启、开机自启，并提供简单的管理界面。

**1. 安装 PM2：**

Bash

```
sudo npm install -g pm2
```

**2. 后台启动 vibe-kanban：**

Bash

```
# 注意这里需要用引号把启动命令包起来
pm2 start "HOST=0.0.0.0 PORT=9999 npx vibe-kanban" --name vibe-kanban
```

```
shenwei@shenwei-ubuntu-2:~$ pm2 start "HOST=0.0.0.0 PORT=9999 npx vibe-kanban" --name vibe-kanban

                        -------------

__/\\\\\\\\\\\\\____/\\\\____________/\\\\____/\\\\\\\\\_____
 _\/\\\/////////\\\_\/\\\\\\________/\\\\\\__/\\\///////\\\___
  _\/\\\_______\/\\\_\/\\\//\\\____/\\\//\\\_\///______\//\\\__
   _\/\\\\\\\\\\\\\/__\/\\\\///\\\/\\\/_\/\\\___________/\\\/___
    _\/\\\/////////____\/\\\__\///\\\/___\/\\\________/\\\//_____
     _\/\\\_____________\/\\\____\///_____\/\\\_____/\\\//________
      _\/\\\_____________\/\\\_____________\/\\\___/\\\/___________
       _\/\\\_____________\/\\\_____________\/\\\__/\\\\\\\\\\\\\\\_
        _\///______________\///______________\///__\///////////////__


                          Runtime Edition

        PM2 is a Production Process Manager for Node.js applications
                     with a built-in Load Balancer.

                Start and Daemonize any application:
                $ pm2 start app.js

                Load Balance 4 instances of api.js:
                $ pm2 start api.js -i 4

                Monitor in production:
                $ pm2 monitor

                Make pm2 auto-boot at server restart:
                $ pm2 startup

                To go further checkout:
                http://pm2.io/


                        -------------

[PM2] Spawning PM2 daemon with pm2_home=/home/shenwei/.pm2
[PM2] PM2 Successfully daemonized
[PM2] Starting /usr/bin/bash in fork_mode (1 instance)
[PM2] Done.
┌────┬────────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name           │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├────┼────────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 0  │ vibe-kanban    │ default     │ N/A     │ fork    │ 2232962  │ 0s     │ 0    │ online    │ 0%       │ 13.9mb   │ shenwei  │ disabled │
└────┴────────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘

```


**3. 如何管理：**

- **查看状态**：`pm2 list`
    
- **查看实时日志**：`pm2 logs vibe-kanban`
    
- **手动停止**：`pm2 stop vibe-kanban`
    
- **重启**：`pm2 restart vibe-kanban`
    
- **彻底删除进程记录**：`pm2 delete vibe-kanban`


**4. 打开vibe-kanban：**
http://192.168.3.45:9999/