vojo/README.md
2026-04-13 22:22:01 +03:00

1.8 KiB

Vojo

A Matrix client focusing primarily on simple, elegant and secure interface. The main goal is to have an instant messaging application that is easy on people and has a modern touch.

Based on Cinny (MIT license).

Getting started

The web app is available at vojo.chat.

Self-hosting

To host Vojo on your own, build from source and serve the files from dist/ using your preferred webserver.

  • The default homeserver is defined in config.json.

  • You need to set up redirects to serve the assets. Example configurations: nginx, caddy.

  • To deploy on a subdirectory, rebuild the app after updating the base path in build.config.ts.

Local development

Tip

We recommend using a version manager as versions change very quickly. NVM on Windows or nvm on Linux/macOS are good choices.

Execute the following commands to start a development server:

npm ci # Installs all dependencies
npm start # Serve a development version

To build the app:

npm run build # Compiles the app into the dist/ directory

Running with Docker

This repository includes a Dockerfile, which builds the application from source and serves it with Nginx on port 80. To use this locally, you can build the container like so:

docker build -t vojo:latest .

You can then run the container you've built with a command similar to this:

docker run -p 8080:80 vojo:latest

This will forward your localhost port 8080 to the container's port 80. You can visit the app in your browser by navigating to http://localhost:8080.