Documentation / 02

Run Devin Pocket on Linux

Devin Pocket runs on Linux as a local Node.js server with a browser interface. Install Node.js 22 or newer and Devin CLI, then launch Pocket with npx or install it globally. Sign in with your Devin account and open the loopback URL. No separate Pocket account or API key is required.

Last updated ·Node.js 22+

Before you begin

  • Linux, Node.js 22+, npm or pnpm, and a modern browser.
  • Devin CLI and a Devin account. Internet for authentication and agent operation.

Step by step

  1. 01

    Install Devin CLI if missing

    Use the official CLI installer; inspect the script first. Pocket does not replace the agent.

    curl -fsSL https://cli.devin.ai/install.sh | bash
  2. 02

    Choose your Pocket installation

    npx starts without a permanent global install. Alternatively use npm or pnpm globally. A global install needs a writable prefix; pnpm setup fixes global-bin PATH configuration.

    npx devin-pocket
    npm i -g devin-pocket
    pnpm add -g devin-pocket
    pnpm setup
  3. 03

    Or use the general installer

    This installs Node.js if needed, prefers pnpm and falls back to npm. It only prints instructions if Devin CLI is missing. It does not start Pocket.

    curl -fsSL https://raw.githubusercontent.com/BOTOOM/devin-pocket/main/install.sh | bash
  4. 04

    Start and authorize

    For a global install, start the background supervisor. Open http://127.0.0.1:7777, then sign in to Devin in the PWA. If needed, authorize manually on the same host.

    devin-pocket start
    devin auth login
  5. 05

    Check the host

    Use doctor for runtime/auth/ACP checks and logs for recent events. Stop the tracked process when done.

    devin-pocket doctor
    devin-pocket logs -n 100
    devin-pocket stop

Keep in mind

  • No command means start. Normal start runs a background supervisor with bounded crash retries.
  • The host must stay running. Bind to loopback unless you have deliberately reviewed the remote-access guide.

Source of truth: the Devin Pocket README and implementation.

README