Setup guide

Set up a Postgres cluster that stays up.

Compare the recommended setups, then choose your system, how many computers and how they connect. You get the steps for that setup.

Step by step

Your setup, step by step.

The commands are the real ones. There is no public download yet, and so far CoyoteDB has been tested on macOS and Linux; Windows has not been tested yet.

System
Computers
Network

Your steps

2 computers + witness on Linux

Add a "witness": a tiny helper that holds no data and only votes. Now switch-over happens on its own.

  1. Install CoyoteDB on both Linux computers

    CoyoteDB is one small app. Every computer that holds data runs Linux.

  2. Connect them over Tailscale

    Put every computer on the same tailnet, so they can reach each other. Nodes talk to each other over one encrypted port.

  3. Start the first node

    First computer

    This downloads and runs PostgreSQL 18 for you.

    $ coyote up
    $ coyote invite
    
  4. Join the second computer

    Second computer

    Paste the invite code from the first node.

    $ coyote join <code>
    
  5. Add the witness

    Witness machine (any system)

    The witness holds no data and only votes. It can run on any system type.

    $ coyote witness <code>
    
  6. Check that it is healthy

    Any node

    See which nodes are up and which one is the main node.

    $ coyote status
    
  7. Point your app at it

    Use any node’s address with the normal Postgres port. Each node passes you to the current main node.