Skip to main content
This section walks you through installing Comis on your server or development machine. There are five ways to get started — pick the one that fits your workflow best.

​
Quick Install

One-liner — installs Node.js, system dependencies, a dedicated comis user, and registers the daemon as a systemd service:
This is the same script used by the VPS guide and works on macOS and Linux. On Linux the dedicated comis user is the default: run as root, the installer creates it directly; run as a regular user, it offers to re-run itself with sudo. Pass --no-user (or set COMIS_NO_USER=1) to install for the current user instead. Non-interactive non-root runs (no TTY, or --no-prompt) stop and ask you to pick one of the two explicitly.

​
Choose Your Setup Method

Linux Install

Recommended for most users. Step-by-step procedure with npm install -g comisai, setup wizard, and comis daemon start.

VPS Install

Deploy on Hostinger, DigitalOcean, Hetzner, or any Ubuntu VPS in under 10 minutes using the one-line installer.

Docker

Run Comis in a container. No system-level Node.js installation needed — everything runs inside Docker.

Render.com

Deploy from Docker Hub to Render in ~5 minutes. Managed Linux host, automatic HTTPS, persistent disk, public URL. No server to provision.

Manual Configuration

Full control over every setting. For experienced users who want to build their config.yaml from scratch.

​
Comparison

All four methods produce the same result: a running Comis daemon with a web dashboard at http://localhost:4766. The difference is how much the tooling handles for you versus how much you configure by hand.

​
What Gets Installed

Regardless of which method you choose, Comis sets up:
  • The comis CLI — a command-line tool for managing your agents, running diagnostics, and controlling the daemon.
  • A background daemon — the process that keeps your agents running, serves the web dashboard, and handles incoming messages from connected channels.
  • A configuration directory at ~/.comis/ containing your config file, environment secrets, and local database.
The setup wizard creates sensible defaults for all of these. The manual path lets you customize each one individually.
Already installed? If Comis is already running and you want to check that everything is healthy, skip ahead to the Verification page for diagnostic steps.

​
Before You Begin

Make sure your system meets the minimum requirements before starting any installation method. The Requirements page lists everything you need — hardware specs, software versions, and AI provider accounts. Most users only need Node.js 22+, basic build tools, and an API key from one AI provider.

​
Explore the Installation Guides

Requirements

Hardware, software, and account prerequisites.

Install on Linux

Step-by-step procedure for Ubuntu, Fedora, and Arch.

Install on a VPS

One-line installer for Hostinger, DigitalOcean, Hetzner, and others.

Install with Docker

Container-based setup with Docker Compose.

Deploy on Render.com

Hosted deploy from Docker Hub with persistent disk and HTTPS.

Configuration

Customize config.yaml and connect channels.

Verification

Confirm your installation is healthy.