---
title: Install vmauth on CentOS using the Snap Store | Snapcraft
description: Get the latest version of vmauth for on CentOS - vmauth is a simple auth
  proxy, router and load balancer for VictoriaMetrics
url: https://snapcraft.io/install/vmauth/centos
---

[Canonical Snapcraft](https://snapcraft.io/)

# Install vmauth on **CentOS**

# vmauth

[Denys Holius (denisgolius)](https://snapcraft.io/publisher/denisgolius "View all snaps from Denys Holius (denisgolius)")

* [Denys Holius (denisgolius)](https://snapcraft.io/publisher/denisgolius "View all snaps from Denys Holius (denisgolius)")
* [Devices and IoT](https://snapcraft.io/search?categories=devices-and-iot)
* [Server and Cloud](https://snapcraft.io/search?categories=server-and-cloud)

[Install](https://snapcraft.io/install/vmauth/centos#install)

#### vmauth is a simple auth proxy, router and load balancer for VictoriaMetrics

It reads auth credentials from `Authorization` http header (Basic Auth, `Bearer token` and InfluxDB authorization is supported), matches them against configs pointed by -auth.config command-line flag and proxies incoming HTTP requests to the configured per-user `url_prefix` on successful match. The `-auth.config` can point to either local file or to http url.

**Quick start**

Just download `vmutils-*` archive from releases page, unpack it and pass the following flag to vmauth binary in order to start authorizing and routing requests:

`/path/to/vmauth -auth.config=/path/to/auth/config.yml`

After that vmauth starts accepting HTTP requests on port `8427` and routing them according to the provided -auth.config. The port can be modified via `-httpListenAddr` command-line flag.

The auth config can be reloaded via the following ways:

* By passing `SIGHUP` signal to `vmauth`.
* By querying `/-/reload` http endpoint. This endpoint can be protected with `-reloadAuthKey` command-line flag. See security docs for more details.
* By specifying -configCheckInterval command-line flag to the interval between config re-reads. For example, `-configCheckInterval=5s` will re-read the config and apply new changes every 5 seconds.

See how vmauth used in docker-compose env at <https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/deployment/docker/README.md#victoriametrics-cluster>.

Pass `-help` to `vmauth` in order to see all the supported command-line flags with their descriptions.

Feel free contacting us if you need customized auth proxy for VictoriaMetrics with the support of LDAP, SSO, RBAC, SAML, accounting and rate limiting such as <https://docs.victoriametrics.com/vmgateway.html> .

### Package name

* vmauth

---

### License

* Apache-2.0

---

### Last updated

* 9 December 2024 - latest/stable
* 9 December 2024 - latest/edge

---

### Websites

* [victoriametrics.com](https://victoriametrics.com/ "https://victoriametrics.com/")

---

### Contact

* [info@victoriametrics.com](mailto:info@victoriametrics.com "mailto:info@victoriametrics.com")

---

### Source code

* [github.com/VictoriaMetrics/VictoriaMetrics](https://github.com/VictoriaMetrics/VictoriaMetrics "https://github.com/VictoriaMetrics/VictoriaMetrics")

---

### Report a bug

* [github.com/VictoriaMetrics/VictoriaMetrics/issues/new/choose](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/new/choose "https://github.com/VictoriaMetrics/VictoriaMetrics/issues/new/choose")

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/install/vmauth/centos#report-snap-modal)

---

## Enable snaps on CentOS and install vmauth

Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.

Snaps are discoverable and installable from the [Snap Store](https://snapcraft.io/store), an app store with an audience of millions.

### Enable snapd

Snap is available for [CentOS 7.6+](https://snapcraft.io/install/vmauth/centos), and Red Hat Enterprise Linux 7.6+, from the [Extra Packages for Enterprise Linux](https://fedoraproject.org/wiki/EPEL) (EPEL) repository. The EPEL repository can be added to your system with the following command:

```
sudo yum install epel-release
```

Snap can now be installed as follows:

```
sudo yum install snapd
```

Once installed, the *systemd* unit that manages the main snap communication socket needs to be enabled:

```
sudo systemctl enable --now snapd.socket
```

To enable *classic* snap support, enter the following to create a symbolic link between `/var/lib/snapd/snap` and `/snap`:

```
sudo ln -s /var/lib/snapd/snap /snap
```

Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly.

### Install vmauth

To install vmauth, simply use the following command:

```
sudo snap install vmauth
```

### Other popular snaps…

[See more...](https://snapcraft.io/search?categories=featured)

[See more in Featured](https://snapcraft.io/search?categories=featured)

### More things to do…

#### [Get the snap store](https://snapcraft.io/snap-store)

Browse and find snaps from the convenience of your desktop using the snap store snap.

#### [Learn more about snaps](https://snapcraft.io/docs)

Interested to find out more about snaps? Want to publish your own application? Visit [snapcraft.io](https://snapcraft.io/) now.

[Back to top](https://snapcraft.io/install/vmauth/centos)

© 2026 Canonical Ltd.
Ubuntu and Canonical are registered trademarks of Canonical Ltd.

Powered by [Charmed Kubernetes](https://www.ubuntu.com/kubernetes)

[Join the forum](https://forum.snapcraft.io/), contribute to or report problems with,
[snapd](https://bugs.launchpad.net/snapd),
[Snapcraft](https://bugs.launchpad.net/snapcraft),
or [this site](https://github.com/canonical/snapcraft.io/issues/new).

* [Share on Twitter](https://twitter.com/snapcraftio)
* [Share on Facebook](https://www.facebook.com/snapcraftio)
* [Share on YouTube](https://www.youtube.com/snapcraftio)

* [Terms of Service](https://ubuntu.com/legal/terms-and-policies/snap-store-terms)
* [Data privacy](https://www.ubuntu.com/legal/data-privacy)
* [Manage your tracker settings](https://snapcraft.io/install/vmauth/centos)
* [Service status](https://status.snapcraft.io/)
* [Other functions](https://dashboard.snapcraft.io/)
* [Contact us](https://snapcraft.io/about/contact-us)
