# Uptime Kuma Deploys Uptime Kuma, a self-hosted monitoring dashboard. Track uptime of your websites, APIs, and services. Accessible via browser with a floating IP. #### Architecture: * 1 Instance (Nano — 2 vCPU, 2 GB RAM) * 1 private network (10.200.0.0/24) * 1 floating IP (public access) * 30 GB boot volume * Security group allows SSH, port 3001 #### What is automated: * Instance creation with selected flavor and image * Private network, subnet, and router * Floating IP assigned to Instance * Security group with ports 22, 3001 * Docker installed from official repository * Uptime Kuma container started with persistent volume * Auto-restart enabled #### Before you launch: Update these parameters in the template or at launch time: | Parameter | Default | What to change | | ---------------- | ---------------------- | ------------------------------------------------------------------------------ | | `key_name` | `stack-test` | **Required.** Replace with your SSH keypair name from **Compute → Key Pairs**. | | `image` | `Ubuntu 22.04 Updated` | Change only if you need a different OS image. | | `flavor` | `Nano` | Change only if you want a different VM size. | | `volume_size` | `30` | Increase if needed (in GB). | | `public_network` | `Public` | Do not change unless your cloud has a different external network name. | {% hint style="info" %} **key\_name is the only parameter you must change before launching.** Everything else works with defaults. {% endhint %} #### Uptime Kuma Template Save as `uptime-kuma.yaml` and upload via Orchestration or Past Direct. ``` heat_template_version: 2021-04-16 description: > NeevCloud: Uptime Kuma monitoring and status page via Docker. Accessible on port 3001. parameters: image: type: string default: Ubuntu 22.04 Updated flavor: type: string default: Nano volume_size: type: number description: Boot volume size in GB default: 30 public_network: type: string default: Public key_name: type: string default: stack-test resources: net: type: OS::Neutron::Net properties: name: uptimekuma-net subnet: type: OS::Neutron::Subnet properties: network: { get_resource: net } cidr: 10.200.0.0/24 dns_nameservers: [8.8.8.8, 8.8.4.4] router: type: OS::Neutron::Router properties: external_gateway_info: network: { get_param: public_network } router_interface: type: OS::Neutron::RouterInterface properties: router: { get_resource: router } subnet: { get_resource: subnet } sg: type: OS::Neutron::SecurityGroup properties: name: uptimekuma-sg rules: - { direction: ingress, protocol: tcp, port_range_min: 22, port_range_max: 22, remote_ip_prefix: 0.0.0.0/0 } - { direction: ingress, protocol: tcp, port_range_min: 3001, port_range_max: 3001, remote_ip_prefix: 0.0.0.0/0 } - { direction: ingress, protocol: icmp, remote_ip_prefix: 0.0.0.0/0 } server: type: OS::Nova::Server properties: name: uptimekuma-server flavor: { get_param: flavor } key_name: { get_param: key_name } networks: - network: { get_resource: net } security_groups: - { get_resource: sg } block_device_mapping_v2: - boot_index: 0 delete_on_termination: true image: { get_param: image } volume_size: { get_param: volume_size } user_data_format: RAW user_data: | #!/bin/bash set -e export DEBIAN_FRONTEND=noninteractive # Install Docker apt-get update -y apt-get install -y ca-certificates curl gnupg install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg chmod a+r /etc/apt/keyrings/docker.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" > /etc/apt/sources.list.d/docker.list apt-get update -y apt-get install -y docker-ce docker-ce-cli containerd.io # Run Uptime Kuma docker run -d \ --name uptime-kuma \ --restart=always \ -p 3001:3001 \ -v uptime-kuma-data:/app/data \ louislam/uptime-kuma:1 fip: type: OS::Neutron::FloatingIP properties: floating_network: { get_param: public_network } fip_assoc: type: OS::Neutron::FloatingIPAssociation properties: floatingip_id: { get_resource: fip } port_id: { get_attr: [server, addresses, { get_resource: net }, 0, port] } outputs: uptimekuma_url: description: Uptime Kuma URL (create admin account on first login) value: str_replace: template: http://HOST:3001 params: HOST: { get_attr: [fip, floating_ip_address] } floating_ip: description: Public IP value: { get_attr: [fip, floating_ip_address] } ``` #### Access: * Dashboard: * SSH: ssh ubuntu\@floating-ip #### Deploy: 1. Go to [Orchestration](/neevcloud-products/orchestration-infrastructure-as-code/web-server-stack-template.md) 2. Upload uptime-kuma.yaml 3. Select keypair, flavor, image 4. Launch stack 5. Open `http://floating-ip:3001` and create your admin account {% hint style="info" %} **Note:** First boot takes 2–3 minutes for Docker and Uptime Kuma to pull and start. {% endhint %} *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.neevcloud.com/neevcloud-guide/stack-automation-library/monitoring/uptime-kuma.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.