InfluxDB is an open source database with high read and write speed developed by InfluxData. It is written in Go and is designed for developers who create time series-based applications. It can store large amounts of time series data and quickly perform real-time analysis on that data. You can install it on multiple operating systems and it supports a variety of client libraries.
In this post, we'll explain how to install InfluxDB on Ubuntu 22.04.
Requirements
- A server running Ubuntu 22.04.
- A root password is set up on your server.
First steps
First, update all system packages to the latest version using the following command:
apt update -y apt upgrade -y
Once your system is up to date, use the following command to install any other dependencies you need:
apt install wget curl gnupg2 -y
After you have installed all dependencies, you can proceed with the installation of InfluxDB.
Install InfluxDB
By default, InfluxDB is not available in the default repository of Ubuntu 22.04. Therefore, you need to create a repository for InfluxDB.
First, add the InfluxDB GPG key with the following command:
wget -qO- https://repos.influxdata.com/influxdb.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdb.gpg > /dev/null
Next, add the IngluxDB repository to the APT with the following command:
export DISTRIB_ID=$(lsb_release -si); export DISTRIB_CODENAME=$(lsb_release -sc)
echo "deb [signed-by=/etc/apt/trusted.gpg.d/influxdb.gpg] https://repos.influxdata.com/${DISTRIB_ID,,} ${DISTRIB_CODENAME} stable" | tee /etc/apt/sources.list.d/influxdb.list > /dev/null
Next, update the repository cache and install InfluxDB with the following command:
apt update -y apt install influxdb2
Once InfluxDB is installed, you can proceed to the next step.
Start InfluxDB service
By default, the InfluxDB service is managed by systemd. You can start and stop the InfluxDB service with the following command:
systemctl start influxdb systemctl stop influxdb
To enable InfluxDB when you reboot the system, run the following command:
systemctl enable influxdb
To check the status of InfluxDB, run the following command:
systemctl status influxdb
You should get the following output:
? influxdb.service - InfluxDB is an open-source, distributed, time series database
Loaded: loaded (/lib/systemd/system/influxdb.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2022-12-05 14:35:23 UTC; 11s ago
Docs: https://docs.influxdata.com/influxdb/
Process: 12075 ExecStart=/usr/lib/influxdb/scripts/influxd-systemd-start.sh (code=exited, status=0/SUCCESS)
Main PID: 12076 (influxd)
Tasks: 8 (limit: 4579)
Memory: 45.2M
CPU: 782ms
CGroup: /system.slice/influxdb.service
??12076 /usr/bin/influxd
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12076]: ts=2022-12-05T14:35:23.568768Z lvl=info msg="Open store (end)" log_id=0e_gFea0000>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12076]: ts=2022-12-05T14:35:23.568805Z lvl=info msg="Starting retention policy enforcemen>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12076]: ts=2022-12-05T14:35:23.568818Z lvl=info msg="Starting precreation service" log_id>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12076]: ts=2022-12-05T14:35:23.569835Z lvl=info msg="Starting query controller" log_id=0e>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12076]: ts=2022-12-05T14:35:23.573680Z lvl=info msg="Configuring InfluxQL statement execu>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12076]: ts=2022-12-05T14:35:23.580309Z lvl=info msg=Starting log_id=0e_gFea0000 service=t>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12076]: ts=2022-12-05T14:35:23.582658Z lvl=info msg=Listening log_id=0e_gFea0000 service=>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12098]: Command "print-config" is deprecated, use the influx-cli command server-config to>
Dec 05 14:35:23 ubuntu2204 influxd-systemd-start.sh[12075]: InfluxDB started
At this point InfluxDB is started and listening on port 8086, you can check this with the following command:
ss -tunelp | grep 8086
You should see the following output:
tcp LISTEN 0 4096 *:8086 *:* users:(("influxd",pid=12076,fd=10)) uid:998 ino:87540 sk:17 cgroup:/system.slice/influxdb.service v6only:0 <->
InfluxDB setup
By default InfluxDB is not configured. So you have to configure it via the command line.
influx setup
You will be prompted to set the admin user and password as shown below:
> Welcome to InfluxDB 2.0! ? Please type your primary username admin ? Please type your password *********** ? Please type your password again *********** ? Please type your primary organization name Howtoforge ? Please type your primary bucket name IT ? Please type your retention period in hours, or 0 for infinite 2 ? Setup with these parameters? Username: admin Organization: Howtoforge Bucket: IT Retention Period: 2h0m0s Yes User Organization Bucket admin Howtoforge IT
Access InfluxDB Web UI.
At this point InfluxDB is configured and listening on port 8086, you can verify this with the following command:
ss -antpl | grep 8086
You will get the following output:
LISTEN 0 4096 *:8086 *:* users:(("influxd",pid=12076,fd=10))
Now open your web browser and access the InfluxDB web UI using the URL http://your-server-ip:8086. You should see the login page of InfluxDB:
Enter your admin username and password and click the LOGIN button. On the following page, you should see the InfluxDB dashboard:
Conclusion
Congratulations. You have successfully installed InfluxDB on Ubuntu 22.04. You can now use InfluxDB in the production environment and manage it through a web-based interface.