From efe17a5e63e51282e35aa5a86b9e3d58fe4c6471 Mon Sep 17 00:00:00 2001 From: "push-app-to-main[bot]" <203845782+push-app-to-main[bot]@users.noreply.github.com> Date: Thu, 22 Jan 2026 11:56:59 +0100 Subject: [PATCH] Loki | Alpine-Loki (#11048) * Add loki (ct) * add alpine variant in pr * Add info note about Promtail installation to loki.json Added an informational note to loki.json indicating that Promtail can be optionally installed during setup to collect and ship logs to Loki. * add header * refactor local_ip * fix json * Update alpine-loki-install.sh * refactor * refactor * fix --------- Co-authored-by: push-app-to-main[bot] <203845782+push-app-to-main[bot]@users.noreply.github.com> Co-authored-by: CanbiZ (MickLesk) <47820557+MickLesk@users.noreply.github.com> Co-authored-by: Tobias <96661824+CrazyWolf13@users.noreply.github.com> --- ct/alpine-loki.sh | 71 +++++++++++++++++++++++ ct/headers/alpine-loki | 6 ++ ct/headers/loki | 6 ++ ct/loki.sh | 103 +++++++++++++++++++++++++++++++++ frontend/public/json/loki.json | 51 ++++++++++++++++ install/alpine-loki-install.sh | 86 +++++++++++++++++++++++++++ install/loki-install.sh | 83 ++++++++++++++++++++++++++ 7 files changed, 406 insertions(+) create mode 100644 ct/alpine-loki.sh create mode 100644 ct/headers/alpine-loki create mode 100644 ct/headers/loki create mode 100644 ct/loki.sh create mode 100644 frontend/public/json/loki.json create mode 100644 install/alpine-loki-install.sh create mode 100644 install/loki-install.sh diff --git a/ct/alpine-loki.sh b/ct/alpine-loki.sh new file mode 100644 index 000000000..51eb0071c --- /dev/null +++ b/ct/alpine-loki.sh @@ -0,0 +1,71 @@ +#!/usr/bin/env bash +source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func) +# Copyright (c) 2021-2025 community-scripts ORG +# Author: hoholms +# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE +# Source: https://github.com/grafana/loki + +APP="Alpine-Loki" +var_tags="${var_tags:-alpine;monitoring}" +var_cpu="${var_cpu:-1}" +var_ram="${var_ram:-256}" +var_disk="${var_disk:-1}" +var_os="${var_os:-alpine}" +var_version="${var_version:-3.23}" +var_unprivileged="${var_unprivileged:-1}" + +header_info "$APP" +variables +color +catch_errors + +function update_script() { + if ! apk -e info newt >/dev/null 2>&1; then + apk add -q newt + fi + LXCIP=$(ip a s dev eth0 | awk '/inet / {print $2}' | cut -d/ -f1) + while true; do + CHOICE=$( + whiptail --backtitle "Proxmox VE Helper Scripts" --title "SUPPORT" --menu "Select option" 11 58 3 \ + "1" "Check for Loki Updates" \ + "2" "Allow 0.0.0.0 for listening" \ + "3" "Allow only ${LXCIP} for listening" 3>&2 2>&1 1>&3 + ) + exit_status=$? + if [ $exit_status == 1 ]; then + clear + exit-script + fi + header_info + case $CHOICE in + 1) + $STD apk -U upgrade + msg_ok "Updated successfully!" + exit + ;; + 2) + sed -i -e "s/cfg:server.http_addr=.*/cfg:server.http_addr=0.0.0.0/g" /etc/conf.d/loki + service loki restart + msg_ok "Allowed listening on all interfaces!" + exit + ;; + 3) + sed -i -e "s/cfg:server.http_addr=.*/cfg:server.http_addr=$LXCIP/g" /etc/conf.d/loki + service loki restart + msg_ok "Allowed listening only on ${LXCIP}!" + exit + ;; + esac + done + exit 0 +} + +start +build_container +description + +msg_ok "Completed Successfully!\n" +echo -e "${APP} should be reachable by going to the following URL. + ${BL}http://${IP}:3100${CL} \n" +echo -e "Promtail should be reachable by going to the following URL. + ${BL}http://${IP}:9080${CL} \n" diff --git a/ct/headers/alpine-loki b/ct/headers/alpine-loki new file mode 100644 index 000000000..7e829b1da --- /dev/null +++ b/ct/headers/alpine-loki @@ -0,0 +1,6 @@ + ___ __ _ __ __ _ + / | / /___ (_)___ ___ / / ____ / /__(_) + / /| | / / __ \/ / __ \/ _ \______/ / / __ \/ //_/ / + / ___ |/ / /_/ / / / / / __/_____/ /___/ /_/ / ,< / / +/_/ |_/_/ .___/_/_/ /_/\___/ /_____/\____/_/|_/_/ + /_/ diff --git a/ct/headers/loki b/ct/headers/loki new file mode 100644 index 000000000..a8e58ae7f --- /dev/null +++ b/ct/headers/loki @@ -0,0 +1,6 @@ + __ __ _ + / / ____ / /__(_) + / / / __ \/ //_/ / + / /___/ /_/ / ,< / / +/_____/\____/_/|_/_/ + diff --git a/ct/loki.sh b/ct/loki.sh new file mode 100644 index 000000000..032b67396 --- /dev/null +++ b/ct/loki.sh @@ -0,0 +1,103 @@ +#!/usr/bin/env bash +source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/build.func) +# Copyright (c) 2021-2025 community-scripts ORG +# Author: hoholms +# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE +# Source: https://github.com/grafana/loki + +APP="Loki" +var_tags="${var_tags:-monitoring;logs}" +var_cpu="${var_cpu:-1}" +var_ram="${var_ram:-512}" +var_disk="${var_disk:-2}" +var_os="${var_os:-debian}" +var_version="${var_version:-13}" +var_unprivileged="${var_unprivileged:-1}" + +header_info "$APP" +variables +color +catch_errors + +function update_script() { + header_info + check_container_storage + check_container_resources + + if ! dpkg -s loki >/dev/null 2>&1; then + msg_error "No ${APP} Installation Found!" + exit 1 + fi + + while true; do + CHOICE=$( + whiptail --backtitle "Proxmox VE Helper Scripts" --title "SUPPORT" --menu "Select option" 11 58 3 \ + "1" "Update Loki & Promtail" \ + "2" "Allow 0.0.0.0 for listening" \ + "3" "Allow only ${LOCAL_IP} for listening" 3>&2 2>&1 1>&3 + ) + exit_status=$? + if [ $exit_status == 1 ]; then + clear + exit-script + fi + header_info + case $CHOICE in + 1) + msg_info "Stopping Loki" + systemctl stop loki + if systemctl is-active --quiet promtail 2>/dev/null || dpkg -s promtail >/dev/null 2>&1; then + systemctl stop promtail + fi + msg_ok "Stopped Loki" + + msg_info "Updating Loki" + $STD apt update + $STD apt install -y --only-upgrade loki + if dpkg -s promtail >/dev/null 2>&1; then + $STD apt install -y --only-upgrade promtail + fi + msg_ok "Updated Loki" + + msg_info "Starting Loki" + systemctl start loki + if dpkg -s promtail >/dev/null 2>&1; then + systemctl start promtail + fi + msg_ok "Started Loki" + msg_ok "Updated successfully!" + exit + ;; + 2) + msg_info "Configuring Loki to listen on 0.0.0.0" + sed -i 's/http_listen_address:.*/http_listen_address: 0.0.0.0/' /etc/loki/config.yml + sed -i 's/http_listen_port:.*/http_listen_port: 3100/' /etc/loki/config.yml + systemctl restart loki + msg_ok "Configured Loki to listen on 0.0.0.0" + exit + ;; + 3) + msg_info "Configuring Loki to listen on ${LOCAL_IP}" + sed -i "s/http_listen_address:.*/http_listen_address: $LOCAL_IP/" /etc/loki/config.yml + sed -i 's/http_listen_port:.*/http_listen_port: 3100/' /etc/loki/config.yml + systemctl restart loki + msg_ok "Configured Loki to listen on ${LOCAL_IP}" + exit + ;; + esac + done + exit 0 +} + +start +build_container +description + +msg_ok "Completed successfully!\n" +echo -e "${CREATING}${GN}${APP} setup has been successfully initialized!${CL}" +echo -e "${INFO}${YW} Access loki using the following URL:${CL}" +echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:3100${CL}\n" +if dpkg -s promtail >/dev/null 2>&1; then + echo -e "${INFO}${YW} Access promtail using the following URL:${CL}" + echo -e "${TAB}${GATEWAY}${BGN}http://${IP}:9080${CL}" +fi diff --git a/frontend/public/json/loki.json b/frontend/public/json/loki.json new file mode 100644 index 000000000..c48504fb5 --- /dev/null +++ b/frontend/public/json/loki.json @@ -0,0 +1,51 @@ +{ + "name": "Loki", + "slug": "loki", + "categories": [ + 9 + ], + "date_created": "2026-01-22", + "type": "ct", + "updateable": true, + "privileged": false, + "interface_port": 3100, + "documentation": "https://grafana.com/docs/loki/latest/", + "website": "https://github.com/grafana/loki", + "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/loki.webp", + "config_path": "Debian: /etc/loki/config.yml | Alpine: /etc/loki/loki-local-config.yaml", + "description": "Grafana Loki is a set of open source components that can be composed into a fully featured logging stack. A small index and highly compressed chunks simplifies the operation and significantly lowers the cost of Loki.", + "install_methods": [ + { + "type": "default", + "script": "ct/loki.sh", + "resources": { + "cpu": 1, + "ram": 512, + "hdd": 2, + "os": "debian", + "version": "13" + } + }, + { + "type": "alpine", + "script": "ct/alpine-loki.sh", + "resources": { + "cpu": 1, + "ram": 256, + "hdd": 1, + "os": "alpine", + "version": "3.23" + } + } + ], + "default_credentials": { + "username": null, + "password": null + }, + "notes": [ + { + "text": "Promtail can be optionally installed during setup to collect and ship logs to Loki.", + "type": "info" + } + ] +} diff --git a/install/alpine-loki-install.sh b/install/alpine-loki-install.sh new file mode 100644 index 000000000..69869978a --- /dev/null +++ b/install/alpine-loki-install.sh @@ -0,0 +1,86 @@ +#!/usr/bin/env bash + +# Copyright (c) 2021-2025 community-scripts ORG +# Author: hoholms +# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE +# Source: https://github.com/grafana/loki + +source /dev/stdin <<<"$FUNCTIONS_FILE_PATH" +color +verb_ip6 +catch_errors +setting_up_container +network_check +update_os + +msg_info "Installing Loki" +$STD apk add loki +$STD sed -i '/http_addr/s/127.0.0.1/0.0.0.0/g' /etc/conf.d/loki +mkdir -p /var/lib/loki/{chunks,boltdb-shipper-active,boltdb-shipper-cache} +chown -R loki:grafana /var/lib/loki +mkdir -p /var/log/loki +chown -R loki:grafana /var/log/loki +cat </etc/loki/loki-local-config.yaml +auth_enabled: false + +server: + http_listen_port: 3100 + log_level: info + +common: + instance_addr: 127.0.0.1 + path_prefix: /var/lib/loki + storage: + filesystem: + chunks_directory: /var/lib/loki/chunks + rules_directory: /var/lib/loki/rules + replication_factor: 1 + ring: + kvstore: + store: inmemory + +schema_config: + configs: + - from: 2020-10-24 + store: tsdb + object_store: filesystem + schema: v13 + index: + prefix: index_ + period: 24h + +query_range: + results_cache: + cache: + embedded_cache: + enabled: true + max_size_mb: 100 + +limits_config: + metric_aggregation_enabled: true + +ruler: + alertmanager_url: http://localhost:9093 +EOF +chown loki:grafana /etc/loki/loki-local-config.yaml +chmod 644 /etc/loki/loki-local-config.yaml +echo "output_log=\"\${output_log:-/var/log/loki/output.log}\"" >> /etc/init.d/loki +echo "error_log=\"\${error_log:-/var/log/loki/error.log}\"" >> /etc/init.d/loki +echo "start_stop_daemon_args=\"\${SSD_OPTS} -1 \${output_log} -2 \${error_log}\"" >> /etc/init.d/loki +$STD rc-update add loki default +$STD rc-service loki start +msg_ok "Installed Loki" + +read -rp "Would you like to install Promtail? (y/N): " INSTALL_PROMTAIL +if [[ "${INSTALL_PROMTAIL,,}" =~ ^(y|yes)$ ]]; then + msg_info "Installing Promtail" + $STD apk add loki-promtail + $STD sed -i '/http_addr/s/127.0.0.1/0.0.0.0/g' /etc/conf.d/loki-promtail + $STD rc-update add loki-promtail default + $STD rc-service loki-promtail start + msg_ok "Installed Promtail" +fi + +motd_ssh +customize +cleanup_lxc diff --git a/install/loki-install.sh b/install/loki-install.sh new file mode 100644 index 000000000..6cdc310ea --- /dev/null +++ b/install/loki-install.sh @@ -0,0 +1,83 @@ +#!/usr/bin/env bash + +# Copyright (c) 2021-2025 community-scripts ORG +# Author: bysinka-95 +# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE +# Source: https://github.com/grafana/loki + +source /dev/stdin <<<"$FUNCTIONS_FILE_PATH" +color +verb_ip6 +catch_errors +setting_up_container +network_check +update_os + +setup_deb822_repo \ + "grafana" \ + "https://apt.grafana.com/gpg.key" \ + "https://apt.grafana.com" \ + "stable" \ + "main" + +msg_info "Installing Loki" +$STD apt install -y loki +mkdir -p /var/lib/loki/{chunks,boltdb-shipper-active,boltdb-shipper-cache} +chown -R loki /var/lib/loki +cat </etc/loki/config.yml +auth_enabled: false + +server: + http_listen_port: 3100 + log_level: info + +common: + instance_addr: 127.0.0.1 + path_prefix: /var/lib/loki + storage: + filesystem: + chunks_directory: /var/lib/loki/chunks + rules_directory: /var/lib/loki/rules + replication_factor: 1 + ring: + kvstore: + store: inmemory + +schema_config: + configs: + - from: 2020-10-24 + store: tsdb + object_store: filesystem + schema: v13 + index: + prefix: index_ + period: 24h + +query_range: + results_cache: + cache: + embedded_cache: + enabled: true + max_size_mb: 100 + +limits_config: + metric_aggregation_enabled: true + +ruler: + alertmanager_url: http://localhost:9093 +EOF +chown loki /etc/loki/config.yml +systemctl enable -q --now loki +msg_ok "Installed Loki" + +read -rp "Would you like to install Promtail? (y/N): " INSTALL_PROMTAIL +if [[ "${INSTALL_PROMTAIL,,}" =~ ^(y|yes)$ ]]; then + msg_info "Installing Promtail" + $STD apt install -y promtail + systemctl enable -q --now promtail + msg_ok "Installed Promtail" +fi + +motd_ssh +customize +cleanup_lxc