AMQP Virtual Hosts (vhosts)

What is a vhost?

A vhost in LavinMQ is a logical container that groups connections, exchanges, queues, bindings, user permissions, and other resources within LavinMQ. Each vhost is isolated, allowing management and control of resources separately within the server.

What benefits does a vhost offer?

A vhost in LavinMQ helps separate different applications on the same server. Multiple development instances can exist on the same LavinMQ server.

When a client establishes a connection to the LavinMQ server, it specifies the vhost in which it operates, for example amqp://myuser:mypassword@localhost:5672/myvhost

LavinMQ vhost

Resources such as exchanges and queues are named entities inside the vhost container, making each vhost function as a LavinMQ mini-server. When configuring LavinMQ, at least one vhost is required; by default, it is named “/”.

Vhosts do not share exchanges or queues, and users, policies, and other settings are unique to each vhost.

Using vhosts in LavinMQ

To create a vhost in LavinMQ, use the management interface or the HTTP API. A newly created vhost always has a default set of exchanges, no other entities, and no user permissions.

LavinMQ HTTP API

Create a vhost:

curl -X PUT http://username:password@localhost:15672/api/vhosts/vhost_name

Replace vhost_name with the desired virtual host name.

Grant a user access to the host:

curl -X PUT http://username:password@localhost:15672/api/permissions/vhost_name/username \
-d '{"configure":".*", "write":".*", "read":".*"}' \
-H "Content-Type: application/json"

Replace vhost_name with the vhost name, username with the user’s name, and modify the regex pattern (".*") to restrict permissions.

LavinMQ Management Interface

Log in to the LavinMQ management interface.
Navigate to the Virtual hosts section.
Enter a vhost name and adjust permissions.
Click Add virtual host to create it.

Management Interface vhost

Introduction

Configuration

Language Support

AMQP 0-9-1 Overview

More Exchange Types

More Consumer Features

Queue Deep-dive

Other Features

Reliable Message Delivery

High Availability

Monitoring

Management HTTP API

Tutorials

Networking

LavinMQ CLI