---
title: Install kuma on Linux | Snap Store
description: Get the latest version of kuma for Linux - A cli for uptime-kuma
url: https://snapcraft.io/kuma
---

# kuma

[BigBoot](https://snapcraft.io/publisher/bigboot "View all snaps from BigBoot")

* [BigBoot](https://snapcraft.io/publisher/bigboot "View all snaps from BigBoot")

latest/candidate 1.0.0

Install latest/candidate of kuma

---

**Install using the command line**

```
sudo snap install kuma --candidate
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

kuma is only available on the unstable candidate channel. It could break and change often.

---

### Package name

* kuma

---

### License

* unset

---

### Last updated

* 9 May 2025 - latest/candidate
* 9 May 2025 - latest/edge

---

##### Report a Snap Store violation

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

---

* [Description](https://snapcraft.io/kuma#tab-description)
* [Security](https://snapcraft.io/kuma#tab-security)

#### A cli for uptime-kuma

Kuma CLI is a Command Line Interface (CLI) tool for managing and interacting with Uptime Kuma (1).
With Kuma CLI you can easily configure, monitor and manage your applications from the command line.

All configuration options can also be specified as environment variables:
KUMA\_\_URL="<http://localhost:3001/>"
KUMA\_\_USERNAME="<username>"
KUMA\_\_PASSWORD="<password>"
...

Additionally Kuma CLI will read configuration from ~/snap/kuma/current/.config/kuma/config.{toml,yaml,json}.

Usage: kuma [OPTIONS] [COMMAND]

Commands:
monitor Manage Monitors
notification Manage Notifications
tag Manage Tags
maintenance Manage Maintenances
help Print this message or the help of the given subcommand(s)

Options:
--url <URL>
The URL AutoKuma should use to connect to Uptime Kuma
--username <USERNAME>
The username for logging into Uptime Kuma (required unless auth is disabled)
--password <PASSWORD>
The password for logging into Uptime Kuma (required unless auth is disabled)
--mfa-token <MFA\_TOKEN>
The MFA token for logging into Uptime Kuma (required if MFA is enabled)
--header <KEY=VALUE>
Add a HTTP header when connecting to Uptime Kuma
--connect-timeout <CONNECT\_TIMEOUT>
The timeout for the initial connection to Uptime Kuma [default: 30.0]
--call-timeout <CALL\_TIMEOUT>
The timeout for executing calls to the Uptime Kuma server [default: 30.0]
--format <OUTPUT\_FORMAT>
The output format [default: json] [possible values: json, toml, yaml]
--pretty
Wether the output should be pretty printed or condensed
-h, --help
Print help
-V, --version
Print version

(1) <https://uptime.kuma.pet/>

---

## Install kuma on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the [installing snapd documentation](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/kuma/arch)

[### CentOS](https://snapcraft.io/install/kuma/centos)

[### Debian](https://snapcraft.io/install/kuma/debian)

[### elementary OS](https://snapcraft.io/install/kuma/elementary)

[### Fedora](https://snapcraft.io/install/kuma/fedora)

[### KDE Neon](https://snapcraft.io/install/kuma/kde-neon)

[### Kubuntu](https://snapcraft.io/install/kuma/kubuntu)

[### Manjaro](https://snapcraft.io/install/kuma/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/kuma/pop)

[### openSUSE](https://snapcraft.io/install/kuma/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/kuma/rhel)

[### Ubuntu](https://snapcraft.io/install/kuma/ubuntu)