Official package repository

VelaMQ Install Guide

Use this repository to install VelaMQ on Linux and macOS, configure system services, update packages, and download release artifacts directly.

Debian / Ubuntu

The installer detects amd64 and arm64, configures the apt source, and then you can install VelaMQ with the regular package manager.

One-time repository setup

curl -fsSL https://repo.velamq.com/install.sh | sudo bash

Install and start

sudo apt install velamq
sudo systemctl enable --now velamq

Upgrade

sudo apt update
sudo apt install velamq
sudo systemctl restart velamq

Uninstall

sudo systemctl stop velamq
sudo apt remove velamq

RHEL / Rocky / Alma / CentOS / Fedora

The yum repository supports x86_64 and aarch64. DNF based systems can use the same repository file.

Configure yum repository

sudo curl -fsSL -o /etc/yum.repos.d/velamq.repo \
  https://repo.velamq.com/yum/velamq.repo

Install with yum

sudo yum install velamq
sudo systemctl enable --now velamq

Install with dnf

sudo dnf install velamq
sudo systemctl enable --now velamq

Upgrade

sudo yum update velamq
sudo systemctl restart velamq

macOS Homebrew

Homebrew installs the tap from GitHub and downloads the macOS package from this repository. Apple Silicon and Intel macOS are selected automatically by Homebrew.

Install

brew tap hwkj-tech/velamq
brew install velamq

Start service

brew services start velamq

Upgrade

brew update
brew upgrade velamq
brew services restart velamq

Uninstall

brew services stop velamq
brew uninstall velamq

Service management and paths

Linux service velamq.service
Linux config /etc/velamq/config.toml
Linux data /var/lib/velamq
Linux logs /var/log/velamq

Check status

sudo systemctl status velamq

View logs

sudo journalctl -u velamq -f

Restart after config changes

sudo systemctl restart velamq

Direct downloads

GitHub Pages serves release artifacts directly. Use package managers for production upgrades, or download artifacts manually from:

https://repo.velamq.com/downloads/