To run a Signal TLS proxy, you will need a host that has ports 80 and 443 available and a domain name that points to that host.

1. Install docker and docker compose by following the instructions at https://docs.docker.com/engine/install/ (e.g.: apt update && apt install docker docker-compose-plugin)
2. Ensure your current user has access to docker (adduser $USER docker)
3. Clone this repository
4. Run docker compose up -d --remove-orphans

Your proxy is now running! You can share this with the URL https://signal.tube/#<your_host_name>

If you've previously run a proxy, please update to the most recent version by pulling the most recent changes from main, then restarting your Docker containers:

git pull
docker compose down
docker compose up -d --remove-orphans

We want this proxy to be simple to deploy for a broad population, but we know that it won’t fit all deployments—especially advanced users that already have running servers or specific technology preferences. We welcome contributions that make incremental improvements, updates, and improve compatibility, but aren’t considering significant architectural changes.