@cryptotaxi247 / netdata-1
Code Commits Issues Pulls Sessions CI/CD
master
master
md 144 lines 3.52 KB
Rendered Raw
1 # Install Netdata on Offline Systems
2
3 This guide explains how to install Netdata Agent on systems without internet access.
4
5 Netdata supports offline installation of the Agent using our `kickstart.sh` script.
6
7 This method:
8
9 - Downloads all required files in advance.
10 - Works with static builds only (for now).
11 - Does *not* support automatic updates on offline systems.
12
13 :::note
14
15 Local package tools like `apt-offline` may work for DEB/RPM installs — but we don’t officially support them.
16
17 :::
18
19 :::note
20
21 For offline installation on Windows, see [Install Netdata on Windows](/packaging/windows/WINDOWS_INSTALLER.md#offline-air-gapped-installation). This guide covers UNIX-like systems only.
22
23 :::
24
25 ## Step 1: Prepare the Offline Installation Package
26
27 On your internet-connected machine, you'll need::
28
29 | Requirement | Purpose |
30 |-------------------------|----------------------------|
31 | `curl` or `wget` | Download the script |
32 | `sha256sum` or `shasum` | Verify script downloads |
33 | POSIX-compliant shell | Required to run the script |
34
35 Run the following command:
36
37 - using `wget`
38 ```bash
39 wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh
40 sh /tmp/netdata-kickstart.sh --release-channel stable --prepare-offline-install-source ./netdata-offline
41 ```
42 - or using `curl`
43 ```bash
44 curl https://get.netdata.cloud/kickstart.sh > /tmp/netdata-kickstart.sh
45 sh /tmp/netdata-kickstart.sh --release-channel stable --prepare-offline-install-source ./netdata-offline
46 ```
47
48 :::note
49
50 The folder name `netdata-offline` is just an example — use any name you want.
51 To use the nightly channel instead, replace `stable` with `nightly`.
52
53 :::
54
55 **What's Included**:
56
57 The script creates a directory with all necessary files:
58
59 ```
60 ── netdata-offline
61 ├── channel # Release channel info
62 ├── install.sh # Installation script
63 ├── kickstart.sh # Original kickstart script
64 ├── netdata-*.gz.run # Netdata static packages for different architectures
65 └── sha256sums.txt # Verification hashes
66 ```
67
68 ## Step 2: Transfer to Offline System
69
70 Copy the entire `netdata-offline` directory to your offline system using your preferred method (USB drive, secure copy, etc.).
71
72 :::warning
73
74 Do not rename or modify any files in the package.
75 The installation script expects the exact directory structure and filenames.
76
77 :::
78
79 :::tip
80
81 The folder name `netdata-offline` is just an example — use any name you want.
82
83 :::
84
85 ### Output
86
87 This will create a directory like:
88
89 ```
90 ./netdata-offline/
91 ```
92
93 It will contain everything required to install Netdata offline.
94
95 ---
96
97 ## Choose Release Channel (Optional)
98
99 To prepare for a specific channel (`nightly` or `stable`), add:
100
101 ```bash
102 --release-channel nightly
103 ```
104
105 or
106
107 ```bash
108 --release-channel stable
109 ```
110
111 Example:
112
113 ```bash
114 sh /tmp/netdata-kickstart.sh --release-channel stable --prepare-offline-install-source ./netdata-offline
115 ```
116
117 ---
118
119 ## Install Netdata on the Target (Offline) System
120
121 1. Copy the entire `netdata-offline` directory to your offline system.
122
123 :::warning
124
125 Don't rename or modify the files.
126
127 :::
128
129 2. On the offline system, run:
130
131 ```bash
132 cd netdata-offline
133 sudo ./install.sh
134 ```
135
136 The `install.sh` script accepts the [same parameters](/packaging/installer/methods/kickstart.md#optional-parameters-for-kickstartsh) as `kickstart.sh`, allowing you to customize your installation.
137
138 ## Automatic Updates
139
140 :::note
141
142 Automatic updates are *disabled* by default for offline installations — since there’s no network connection.
143
144 :::