Deploying

NOTE: Python 3.12 or higher is required.

Installation

git clone https://foundry.fsky.io/vel/matrix-vona vona && cd vona
pip install .

pip install git+https://foundry.fsky.io/vel/matrix-vona

Configuration

Please see the configuration guide.

Running the Server

python3 -m vona

The server will start listening on the port defined in /etc/vona/config.toml (default 5000).

Setting up the Reverse Proxy

Nginx

If you use Nginx, add the following server section inside the http section of /etc/nginx/nginx.conf:

server {
	listen 443 ssl;
	server_name myvona.example.com;
	http2 on;

	merge_slashes off;
	client_max_body_size 32M;

	ssl_certificate /etc/nginx/ssl/vona.crt;
	ssl_certificate_key /etc/nginx/ssl/vona.key;
	ssl_prefer_server_ciphers off;
	ssl_protocols TLSv1.3;

	location ~ ^/(_tuwunel|_conduwuit|_continuwuity|_dendrite|_matrix|_synapse|_telodendria|_hammerhead|.well-known/matrix) {
		proxy_pass http://127.0.0.1:5000$request_uri;
	}
}

You need to make some edits. When you are done, run:

sudo systemctl enable --now nginx

Caddy

Create /etc/caddy/conf.d/vona_caddyfile and enter this (substitute for your server name):

myvona.example.com, myvona.example.com:8448 {
	reverse_proxy /_matrix/* 127.0.0.1:5000
	reverse_proxy /_conduwuit/* 127.0.0.1:5000
	reverse_proxy /_continuwuity/* 127.0.0.1:5000
	reverse_proxy /_tuwunel/* 127.0.0.1:5000
	reverse_proxy /_synapse/* 127.0.0.1:5000
	reverse_proxy /_dendrite/* 127.0.0.1:5000
	reverse_proxy /_telodendria/* 127.0.0.1:5000
	reverse_proxy /_hammerhead/* 127.0.0.1:5000
	reverse_proxy /.well-known/matrix/* 127.0.0.1:5000
}

You need to make some edits again. Afterwards, run:

sudo systemctl enable --now caddy

5. Updating Vona

git pull
pip install . --upgrade

pip install git+https://foundry.fsky.io/vel/matrix-vona --upgrade