Quick start

You need Node.js 20 or newer and an account on the dashboard.

1. Install the CLI. It brings two commands: vibe and the MCP server vibe-mcp.

   npm install -g https://dashboard.tja.nrw/vibedeploy-cli.tgz

   Run the same command again to update.

2. Create a token and log in. In the dashboard open Deploy tokens, create a token (one per machine is a good habit) and run the command shown next to it:

   vibe login --token vibe_live_…
   vibe whoami

   The token is stored in ~/.config/vibedeploy/config.json (readable only by you). A token created while an organization is selected deploys to that organization: see Teams.

3. Deploy. In a project folder:

   vibe deploy

   The app is built in the cluster and goes live at https://<name>.tja.nrw. The name comes from the folder; it is saved in vibe.json so later deploys update the same app.

The one rule for your app

Listen on 0.0.0.0 and on the port in the PORT environment variable (8080 by default). A server bound to localhost or a fixed port never becomes reachable. Deploying has the details.

Next

• Let your agent deploy: Use with AI agents
• Data that survives deploys: Persistent storage or Databases
• Something is wrong: vibe status <name> and vibe logs <name> -f, then Troubleshooting