Skip to main content

Self-Hosting

Touca Server and Touca SDKs are all open-source with a permissive Apache-2 license. You can deploy Touca Server locally or to your own cloud infrastructure. We've made the process straightforward and self-serve. If you ever needed help or had any questions, you are welcome to join our Community Discord server, or send us an email.

info

Most of our paid plans include dedicated support and professional services for deploying and upgrading self-hosted instances of Touca.

Prerequisites

Touca server has a few components and services. In the most basic deployment scenario, you could run them as Docker containers on a single machine.

The instructions below help you get started with this common scenario. To run this script, you need a UNIX machine with at least 2GB of RAM, with Docker and Docker Compose.

There is no restriction for the choice of Unix distribution. The instructions below are written for and tested on Ubuntu 20.04 LTS distribution.

Prepare your machine

info

This section helps you install Docker and Docker Compose if you do not have them installed locally. They are provided for completeness.

Run Install Script

We offer a one-liner bash script to help with locally installing Touca Server. Simply run the following command in the terminal to have the script download public Touca docker images and run them.

/bin/bash -c "$(curl -fsSL https://touca.io/install.sh)"

This script interactively asks you the server installation path, among other things. Once it runs to complition, it will redirect you to the locally installed server to perform basic server configurations and create your first user account.

note

Did we miss out a required step? We'd love to hear about your experience. Share your thoughts with support@touca.io.