Tephro (Beta)

Group chat with voice, video and screen sharing, on a server you run yourself.

Client 0.26.0 Server 0.24.0

Features

Text

Channels, threads, replies, reactions, search, file uploads, link previews, encrypted direct messages.

Voice

Channels you drop into. Noise suppression, push-to-talk, a volume for every person.

Video

Cameras in layers, so each viewer gets the size their connection and window can use.

Screen sharing

A screen or one window, up to 60 fps, with the sound of the applications you pick.

Setup — Pick your system

Client

Updates itself.

Download

Tephro-Setup-0.26.0.exe

Windows may warn: not code signed yet.

Then

  1. Open your invite link.
  2. Pick a name and register.

Server

Download

tephro-0.24.0-windows-amd64.exe

Then

ren tephro-0.24.0-windows-amd64.exe tephro-server.exe
.\tephro-server.exe
  1. The first run prints your owner link.
  2. Open TCP and UDP 443.

Server

No client yet.

Download

tephro-0.24.0-macos-arm64
tephro-0.24.0-macos-amd64

Then

mv tephro-0.24.0-macos-* tephro-server
chmod +x tephro-server
./tephro-server
  1. The first run prints your owner link.
  2. Open TCP and UDP 443.

Client

AUR, with yay or paru

yay -S tephro-client-bin
paru -S tephro-client-bin

Download

tephro-client-0.26.0-1-x86_64.pkg.tar.zst

Then

  1. Open your invite link.
  2. Pick a name and register.

Server

AUR, with yay or paru

yay -S tephro-server-bin
paru -S tephro-server-bin

Then

sudo systemctl enable --now tephro-server
sudo -u tephro tephro-server admin invite --owner --data-dir /var/lib/tephro/default
  1. Open TCP and UDP 443.

Client

Also: Mint

Repository (recommended)

sudo curl -fsSL --create-dirs -o /etc/apt/keyrings/tephro.asc https://tephro.chat/repo/tephro.asc
sudo curl -fsSL -o /etc/apt/sources.list.d/tephro.sources https://tephro.chat/repo/tephro.sources
sudo apt update && sudo apt install tephro-client
What this means

Your system checks tephro.chat for new versions when it checks for updates, and installs them as root. These checks carry nothing from your Tephro account; the host sees your IP address, as with any download. Nothing changes unless you add it.

Download (No auto-update)

tephro-client_0.26.0_amd64.deb

Then

  1. Open your invite link.
  2. Pick a name and register.

Server

Also: Mint, Raspberry Pi OS (64-bit)

Repository (recommended)

sudo curl -fsSL --create-dirs -o /etc/apt/keyrings/tephro.asc https://tephro.chat/repo/tephro.asc
sudo curl -fsSL -o /etc/apt/sources.list.d/tephro.sources https://tephro.chat/repo/tephro.sources
sudo apt update && sudo apt install tephro-server
What this means

Your system checks tephro.chat for new versions when it checks for updates, and installs them as root. These checks carry nothing from your Tephro account; the host sees your IP address, as with any download. Nothing changes unless you add it.

Download (No auto-update)

tephro-server_0.24.0_amd64.deb
tephro-server_0.24.0_arm64.deb

Then

sudo systemctl enable --now tephro-server
sudo -u tephro tephro-server admin invite --owner --data-dir /var/lib/tephro/default
  1. Open TCP and UDP 443.

Client

Also: Rocky, Alma

Repository (recommended)

sudo curl -fsSL -o /etc/yum.repos.d/tephro.repo https://tephro.chat/repo/tephro.repo
sudo dnf install tephro-client
What this means

Your system checks tephro.chat for new versions when it checks for updates, and installs them as root. These checks carry nothing from your Tephro account; the host sees your IP address, as with any download. Nothing changes unless you add it.

Download (No auto-update)

tephro-client-0.26.0.x86_64.rpm

Then

  1. Open your invite link.
  2. Pick a name and register.

Server

Also: Rocky, Alma

Repository (recommended)

sudo curl -fsSL -o /etc/yum.repos.d/tephro.repo https://tephro.chat/repo/tephro.repo
sudo dnf install tephro-server
What this means

Your system checks tephro.chat for new versions when it checks for updates, and installs them as root. These checks carry nothing from your Tephro account; the host sees your IP address, as with any download. Nothing changes unless you add it.

Download (No auto-update)

tephro-server-0.24.0.x86_64.rpm
tephro-server-0.24.0.aarch64.rpm

Then

sudo systemctl enable --now tephro-server
sudo -u tephro tephro-server admin invite --owner --data-dir /var/lib/tephro/default
  1. Open TCP and UDP 443.

Client

Also: Leap, Tumbleweed

Repository (recommended)

sudo zypper addrepo https://tephro.chat/repo/tephro.repo
sudo zypper install tephro-client
What this means

Your system checks tephro.chat for new versions when it checks for updates, and installs them as root. These checks carry nothing from your Tephro account; the host sees your IP address, as with any download. Nothing changes unless you add it.

Download (No auto-update)

tephro-client-0.26.0.x86_64.rpm

Then

  1. Open your invite link.
  2. Pick a name and register.

Server

Also: Leap, Tumbleweed

Repository (recommended)

sudo zypper addrepo https://tephro.chat/repo/tephro.repo
sudo zypper install tephro-server
What this means

Your system checks tephro.chat for new versions when it checks for updates, and installs them as root. These checks carry nothing from your Tephro account; the host sees your IP address, as with any download. Nothing changes unless you add it.

Download (No auto-update)

tephro-server-0.24.0.x86_64.rpm
tephro-server-0.24.0.aarch64.rpm

Then

sudo systemctl enable --now tephro-server
sudo -u tephro tephro-server admin invite --owner --data-dir /var/lib/tephro/default
  1. Open TCP and UDP 443.

Client

Overlay

sudo eselect repository add tephro git https://gitlab.com/encenillo/tephro-overlay.git
sudo emaint sync -r tephro
sudo emerge -a net-im/tephro-client-bin

Then

  1. Open your invite link.
  2. Pick a name and register.

Server

Overlay

sudo eselect repository add tephro git https://gitlab.com/encenillo/tephro-overlay.git
sudo emaint sync -r tephro
sudo emerge -a net-im/tephro-server-bin

Then

sudo rc-service tephro-server start   # systemd: sudo systemctl enable --now tephro-server
sudo rc-update add tephro-server default
sudo -u tephro tephro-server admin invite --owner --data-dir /var/lib/tephro/default
  1. Open TCP and UDP 443.

Client

Flake

nix run gitlab:encenillo/tephro-nix#client             # try it
nix profile install gitlab:encenillo/tephro-nix#client # install it

Then

  1. Open your invite link.
  2. Pick a name and register.

Server

System flake

inputs.tephro.url = "gitlab:encenillo/tephro-nix";

modules = [
  inputs.tephro.nixosModules.default
  { services.tephro-server = { enable = true; openFirewall = true; }; }
];

Then

sudo nixos-rebuild switch
sudo -u tephro tephro-server admin invite --owner --data-dir /var/lib/tephro/default

Client

Runs on any distribution. Updates itself.

Download

Tephro-0.26.0.AppImage

Then

chmod +x Tephro-0.26.0.AppImage
./Tephro-0.26.0.AppImage
  1. Open your invite link.
  2. Pick a name and register.

Server

uname -m says which: x86_64 or aarch64.

Download

tephro-0.24.0-linux-amd64
tephro-0.24.0-linux-arm64

Then

mv tephro-0.24.0-linux-* tephro-server
chmod +x tephro-server
./tephro-server
  1. The first run prints your owner link.
  2. Open TCP and UDP 443.

Server

Image

docker run -d --name tephro -p 443:443 -p 443:443/udp \
  -v tephro-data:/data tephrochat/tephro-server

Then

docker exec tephro /tephro-server admin invite --owner
  1. Open TCP and UDP 443.

Server

On the host

pveam update
pveam available --section system | grep debian-13
pveam download local debian-13-standard_<version>_amd64.tar.zst
pct create 120 local:vztmpl/debian-13-standard_<version>_amd64.tar.zst \
  --hostname tephro --unprivileged 1 --features nesting=1 \
  --cores 2 --memory 2048 --rootfs local-lvm:16 \
  --net0 name=eth0,bridge=vmbr0,ip=dhcp --onboot 1
pct start 120 && pct enter 120

In the container

apt update && apt install -y curl ca-certificates
curl -fsSL --create-dirs -o /etc/apt/keyrings/tephro.asc https://tephro.chat/repo/tephro.asc
curl -fsSL -o /etc/apt/sources.list.d/tephro.sources https://tephro.chat/repo/tephro.sources
apt update && apt install -y tephro-server
systemctl enable --now tephro-server
runuser -u tephro -- tephro-server admin invite --owner --data-dir /var/lib/tephro/default
  1. Forward TCP and UDP 443 to the container.

Help

More