diff --git a/_partials/_install-self-hosted-archlinux-based.md b/_partials/_install-self-hosted-archlinux-based.md index 72bf1fd1fa..fc49688394 100644 --- a/_partials/_install-self-hosted-archlinux-based.md +++ b/_partials/_install-self-hosted-archlinux-based.md @@ -1,3 +1,6 @@ + +ArchLinux packages are built by the community. + diff --git a/_partials/_install-self-hosted-debian-based-end.md b/_partials/_install-self-hosted-debian-based-end.md new file mode 100644 index 0000000000..a1dd1bcdee --- /dev/null +++ b/_partials/_install-self-hosted-debian-based-end.md @@ -0,0 +1,51 @@ + +1. **Update your local repository list** + + ```bash + sudo apt update + ``` + +1. **Install TimescaleDB** + + ```bash + sudo apt install timescaledb-2-postgresql-17 postgresql-client-17 + ``` + + To install a specific $TIMESCALE_DB [release][releases-page], set the version. For example: + + `sudo apt-get install timescaledb-2-postgresql-14='2.6.0*' timescaledb-2-loader-postgresql-14='2.6.0*'` + + Older versions of $TIMESCALE_DB may not support all the OS versions listed on this page. + +1. **Tune your $PG instance for TimescaleDB** + + ```bash + sudo timescaledb-tune + ``` + + By default, this script is included with the `timescaledb-tools` package when you install TimescaleDB. Use the prompts to tune your development or production environment. For more information on manual configuration, see [Configuration][config]. If you have an issue, run `sudo apt install timescaledb-tools`. + +1. **Restart $PG** + + ```bash + sudo systemctl restart postgresql + ``` + +1. **Log in to $PG as `postgres`** + + ```bash + sudo -u postgres psql + ``` + You are in the psql shell. + +1. **Set the password for `postgres`** + + ```bash + \password postgres + ``` + + When you have set the password, type `\q` to exit psql. + + +[config]: /self-hosted/:currentVersion:/configuration/ +[releases-page]: https://packagecloud.io/timescale/timescaledb \ No newline at end of file diff --git a/_partials/_install-self-hosted-debian-based-start.md b/_partials/_install-self-hosted-debian-based-start.md new file mode 100644 index 0000000000..b397994739 --- /dev/null +++ b/_partials/_install-self-hosted-debian-based-start.md @@ -0,0 +1,15 @@ + +1. **Install the latest $PG packages** + + ```bash + sudo apt install gnupg postgresql-common apt-transport-https lsb-release wget + ``` + +1. **Run the $PG package setup script** + + ```bash + sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh + ``` + +[config]: /self-hosted/:currentVersion:/configuration/ +[releases-page]: https://packagecloud.io/timescale/timescaledb \ No newline at end of file diff --git a/_partials/_install-self-hosted-debian.md b/_partials/_install-self-hosted-debian.md new file mode 100644 index 0000000000..c9d6dc7917 --- /dev/null +++ b/_partials/_install-self-hosted-debian.md @@ -0,0 +1,26 @@ +import SelfHostedDebianStart from "versionContent/_partials/_install-self-hosted-debian-based-start.mdx"; +import SelfHostedDebianEnd from "versionContent/_partials/_install-self-hosted-debian-based-end.mdx"; + + + + + +1. **Add the $TIMESCALE_DB package** + + ```bash + echo "deb https://packagecloud.io/timescale/timescaledb/debian/ $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/timescaledb.list + ``` + +1. **Install the $TIMESCALE_DB GPG key** + + ```bash + wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg + ``` + + + + + + +[config]: /self-hosted/:currentVersion:/configuration/ +[releases-page]: https://packagecloud.io/timescale/timescaledb \ No newline at end of file diff --git a/_partials/_install-self-hosted-fedora.md b/_partials/_install-self-hosted-fedora.md new file mode 100644 index 0000000000..aff1be5452 --- /dev/null +++ b/_partials/_install-self-hosted-fedora.md @@ -0,0 +1,32 @@ +import SelfHostedRedhatXPlatform from "versionContent/_partials/_install-self-hosted-redhat-x-platform.mdx"; + + + +1. **Install the latest $PG packages** + + ```bash + sudo yum install https://download.postgresql.org/pub/repos/yum/reporpms/F-$(rpm -E %{fedora})-x86_64/pgdg-fedora-repo-latest.noarch.rpm + ``` + +1. **Add the $TIMESCALE_DB repository** + + ```bash + sudo tee /etc/yum.repos.d/timescale_timescaledb.repo < + + + +[config]: /self-hosted/:currentVersion:/configuration/ diff --git a/_partials/_install-self-hosted-redhat-based.md b/_partials/_install-self-hosted-redhat-based.md index 324d0c5707..5be6f58546 100644 --- a/_partials/_install-self-hosted-redhat-based.md +++ b/_partials/_install-self-hosted-redhat-based.md @@ -2,7 +2,7 @@ 1. **Install the latest $PG packages** - + @@ -23,7 +23,7 @@ 1. **Add the $TIMESCALE_DB repository** - + diff --git a/_partials/_install-self-hosted-redhat-rocky.md b/_partials/_install-self-hosted-redhat-rocky.md new file mode 100644 index 0000000000..d23018a98d --- /dev/null +++ b/_partials/_install-self-hosted-redhat-rocky.md @@ -0,0 +1,48 @@ + +1. **Install TimescaleDB** + + To avoid errors, **do not** install $TDB_APACHE and $TDB_COMMUNITY at the same time. + + ```bash + sudo dnf install -y postgresql16-server postgresql16-contrib timescaledb-2-postgresql-16 + ``` + + 1. **Initialize the $PG instance** + + ```bash + sudo /usr/pgsql-16/bin/postgresql-16-setup initdb + ``` + +1. **Tune your $PG instance for TimescaleDB** + + ```bash + sudo timescaledb-tune --pg-config=/usr/pgsql-16/bin/pg_config + ``` + + This script is included with the `timescaledb-tools` package when you install TimescaleDB. + For more information, see [configuration][config]. + +1. **Enable and start $PG** + + ```bash + sudo systemctl enable postgresql-16 + sudo systemctl start postgresql-16 + ``` + +1. **Log in to $PG as `postgres`** + + ```bash + sudo -u postgres psql + ``` + You are now in the psql shell. + +1. **Set the password for `postgres`** + + ```bash + \password postgres + ``` + + When you have set the password, type `\q` to exit psql. + + +[config]: /self-hosted/:currentVersion:/configuration/ diff --git a/_partials/_install-self-hosted-redhat-x-platform.md b/_partials/_install-self-hosted-redhat-x-platform.md new file mode 100644 index 0000000000..6143ecbac4 --- /dev/null +++ b/_partials/_install-self-hosted-redhat-x-platform.md @@ -0,0 +1,65 @@ + +1. **Update your local repository list** + + ```bash + sudo yum update + ``` + +1. **Install TimescaleDB** + + To avoid errors, **do not** install $TDB_APACHE and $TDB_COMMUNITY at the same time. + + ```bash + sudo yum install timescaledb-2-postgresql-17 postgresql17 + ``` + + + + + + On Red Hat Enterprise Linux 8 and later, disable the built-in $PG module: + + `sudo dnf -qy module disable postgresql` + + + + + 1. **Initialize the $PG instance** + + ```bash + sudo /usr/pgsql-17/bin/postgresql-17-setup initdb + ``` + +1. **Tune your $PG instance for TimescaleDB** + + ```bash + sudo timescaledb-tune --pg-config=/usr/pgsql-17/bin/pg_config + ``` + + This script is included with the `timescaledb-tools` package when you install TimescaleDB. + For more information, see [configuration][config]. + +1. **Enable and start $PG** + + ```bash + sudo systemctl enable postgresql-17 + sudo systemctl start postgresql-17 + ``` + +1. **Log in to $PG as `postgres`** + + ```bash + sudo -u postgres psql + ``` + You are now in the psql shell. + +1. **Set the password for `postgres`** + + ```bash + \password postgres + ``` + + When you have set the password, type `\q` to exit psql. + + +[config]: /self-hosted/:currentVersion:/configuration/ diff --git a/_partials/_install-self-hosted-redhat.md b/_partials/_install-self-hosted-redhat.md new file mode 100644 index 0000000000..fb0655995b --- /dev/null +++ b/_partials/_install-self-hosted-redhat.md @@ -0,0 +1,34 @@ + +import SelfHostedRedhatXPlatform from "versionContent/_partials/_install-self-hosted-redhat-x-platform.mdx"; + + + +1. **Install the latest $PG packages** + + ```bash + sudo yum install https://download.postgresql.org/pub/repos/yum/reporpms/EL-$(rpm -E %{rhel})-x86_64/pgdg-redhat-repo-latest.noarch.rpm + ``` + +1. **Add the $TIMESCALE_DB repository** + + ```bash + sudo tee /etc/yum.repos.d/timescale_timescaledb.repo < + + + + +[config]: /self-hosted/:currentVersion:/configuration/ diff --git a/_partials/_install-self-hosted-rocky.md b/_partials/_install-self-hosted-rocky.md new file mode 100644 index 0000000000..a4df221708 --- /dev/null +++ b/_partials/_install-self-hosted-rocky.md @@ -0,0 +1,51 @@ + +import SelfHostedRocky from "versionContent/_partials/_install-self-hosted-redhat-rocky.mdx"; + +$COMPANY supports Rocky Linux 8 and 9 on amd64 only. + + + +1. **Update your local repository list** + + ```bash + sudo dnf update -y + sudo dnf install -y epel-release + ``` + +1. **Install the latest $PG packages** + + ```bash + sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm + ``` + +1. **Add the $TIMESCALE_DB repository** + + ```bash + sudo tee /etc/yum.repos.d/timescale_timescaledb.repo < + + + + +[config]: /self-hosted/:currentVersion:/configuration/ diff --git a/_partials/_install-self-hosted-ubuntu.md b/_partials/_install-self-hosted-ubuntu.md new file mode 100644 index 0000000000..904c609cf0 --- /dev/null +++ b/_partials/_install-self-hosted-ubuntu.md @@ -0,0 +1,29 @@ +import SelfHostedDebianStart from "versionContent/_partials/_install-self-hosted-debian-based-start.mdx"; +import SelfHostedDebianEnd from "versionContent/_partials/_install-self-hosted-debian-based-end.mdx"; + + + + + + ```bash + echo "deb https://packagecloud.io/timescale/timescaledb/ubuntu/ $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/timescaledb.list + ``` + +1. **Install the $TIMESCALE_DB GPG key** + + ```bash + wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/timescaledb.gpg + ``` + + For Ubuntu 21.10 and earlier use the following command: + + `wget --quiet -O - https://packagecloud.io/timescale/timescaledb/gpgkey | sudo apt-key add -` + + + + + + + +[config]: /self-hosted/:currentVersion:/configuration/ +[releases-page]: https://packagecloud.io/timescale/timescaledb \ No newline at end of file diff --git a/self-hosted/install/installation-linux.md b/self-hosted/install/installation-linux.md index c1f8e4ab5e..4f4e5edf26 100644 --- a/self-hosted/install/installation-linux.md +++ b/self-hosted/install/installation-linux.md @@ -7,8 +7,11 @@ keywords: [installation, self-hosted, Debian, Ubuntu, RHEL, Fedora] import WhereTo from "versionContent/_partials/_where-to-next.mdx"; import TestingEnv from "versionContent/_partials/_selfhosted_production_alert.mdx" ; -import SelfHostedDebianBased from "versionContent/_partials/_install-self-hosted-debian-based.mdx"; -import SelfHostedRedhatBased from "versionContent/_partials/_install-self-hosted-redhat-based.mdx"; +import SelfHostedDebian from "versionContent/_partials/_install-self-hosted-debian.mdx"; +import SelfHostedUbuntu from "versionContent/_partials/_install-self-hosted-ubuntu.mdx"; +import SelfHostedRedhat from "versionContent/_partials/_install-self-hosted-redhat.mdx"; +import SelfHostedFedora from "versionContent/_partials/_install-self-hosted-fedora.mdx"; +import SelfHostedRocky from "versionContent/_partials/_install-self-hosted-rocky.mdx"; import SelfHostedArchLinuxBased from "versionContent/_partials/_install-self-hosted-archlinux-based.mdx"; import AddTimescaleDBToDB from "versionContent/_partials/_add-timescaledb-to-a-database.mdx"; @@ -45,18 +48,37 @@ To keep your current $PG installation, [Install from source][install-from-source - + - + - + - + + + + + + + + + + + + + + + + + + + +