CoPhrase

Self-hosting

Run the CoPhrase server yourself with Docker, and connect the desktop, web and mobile apps to it.

The CoPhrase server is the same one that runs our hosted service. Run it yourself to use the web and mobile apps, keep mail syncing while your devices are off, and share one setup across a team.

Requirements

  • Docker with Compose
  • A domain name with HTTPS for the web and mobile apps
  • Your own Google and Microsoft OAuth clients, if you connect those accounts

Start the server

git clone https://github.com/amicalhq/cophrase
cd cophrase
cp .env.example .env
docker compose up -d

Open the server's address in a browser to create the first account. The first person to sign up becomes the owner.

Connect your apps

In the desktop app, open Settings → Server and enter your server's address. Your accounts move across without losing mail, drafts or settings. The iPhone, Android and web apps ask for the server address when you sign in.

Updates

docker compose pull && docker compose up -d

Database migrations run on start.

Shared inboxes

Shared inboxes and team features on your own server need a licence. Talk to us.

On this page