Self-host OvertChat

Make it yours.

Set up OvertChat once on a computer you control. Connect your models, then use the same server from your browser, desktop, or phone.

Already have a server? Get the app
  1. Run the installer

    Open a terminal on your server computer and paste this command. On a Mac, run it as your normal user while logged in to the desktop.

    Linux and macOS:

    terminal
    curl -fsSL https://overtchat.com/install | sh

    Windows, in PowerShell as your normal desktop user:

    PowerShell
    irm https://overtchat.com/install.ps1 | iex

    On Windows, enable Docker Desktop’s start-at-sign-in setting. The server needs an awake PC and a signed-in user. Native coding-agent connections also require Node.js 22 or newer.

    The guided setup configures Docker, generates secrets, and manages updates. You don’t need to edit an environment file.

  2. Choose how you’ll connect

    Follow the prompts to use OvertChat on this computer, on your home network, or remotely. For phones and other computers at home, choose your home network.

    To use it from anywhere, choose OvertChat Cloud (beta) for an address like name.overtchat.app. For private remote access, install and connect Tailscale on your server first, then choose the Tailscale option. Advanced setup supports your own HTTPS address and reverse proxy.

    Search, speech, and coding-agent connections are optional. You can change these choices later with overtchat setup.

  3. Open your server & connect a model

    Open the address printed at the end of setup. Create the first account to become the administrator, then add your local model endpoint or hosted provider in the web app.

    Add accounts for other people in Settings → Users. Share your server address so they can sign in with their own account.

  4. Take your chats with you

    Keep using your browser, or choose an available desktop or mobile app. Enter the same server address and sign in. On another device, use an address it can reach, not localhost.

    Download an app

Keep it running

Run overtchat status to check your server, overtchat update to update it, or overtchat setup to change your configuration.

Need more detail?

The operator guide covers networking, speech, backups, updates, and troubleshooting.

Read the operator guide on GitHub