Skip to content
3 changes: 3 additions & 0 deletions _partials/_install-self-hosted-archlinux-based.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@

ArchLinux packages are built by the community.

<Procedure>


Expand Down
51 changes: 51 additions & 0 deletions _partials/_install-self-hosted-debian-based-end.md
Original file line number Diff line number Diff line change
@@ -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
22 changes: 22 additions & 0 deletions _partials/_install-self-hosted-debian-based-start.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@

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
```

If you want to do some development on $PG, add the libraries:
```
sudo apt install postgresql-server-dev-17
```



[config]: /self-hosted/:currentVersion:/configuration/
[releases-page]: https://packagecloud.io/timescale/timescaledb
26 changes: 26 additions & 0 deletions _partials/_install-self-hosted-debian.md
Original file line number Diff line number Diff line change
@@ -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";

<Procedure>

<SelfHostedDebianStart />

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
```

<SelfHostedDebianEnd />

</Procedure>


[config]: /self-hosted/:currentVersion:/configuration/
[releases-page]: https://packagecloud.io/timescale/timescaledb
32 changes: 32 additions & 0 deletions _partials/_install-self-hosted-fedora.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
import SelfHostedRedhatXPlatform from "versionContent/_partials/_install-self-hosted-redhat-x-platform.mdx";

<Procedure>

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 <<EOL
[timescale_timescaledb]
name=timescale_timescaledb
baseurl=https://packagecloud.io/timescale/timescaledb/el/9/\$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL
```

<SelfHostedRedhatXPlatform />

</Procedure>

[config]: /self-hosted/:currentVersion:/configuration/
4 changes: 2 additions & 2 deletions _partials/_install-self-hosted-redhat-based.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

1. **Install the latest $PG packages**

<Terminal>
<Terminal persistKey="os-redhat">

<tab label='Red Hat'>

Expand All @@ -23,7 +23,7 @@

1. **Add the $TIMESCALE_DB repository**

<Terminal>
<Terminal persistKey="os-redhat">

<tab label='Red Hat'>

Expand Down
48 changes: 48 additions & 0 deletions _partials/_install-self-hosted-redhat-rocky.md
Original file line number Diff line number Diff line change
@@ -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/
65 changes: 65 additions & 0 deletions _partials/_install-self-hosted-redhat-x-platform.md
Original file line number Diff line number Diff line change
@@ -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
```

<!-- hack until we have bandwidth to rewrite this linting rule -->

<!-- markdownlint-disable TS007 -->
<Highlight type="note">
On Red Hat Enterprise Linux 8 and later, disable the built-in $PG module:

`sudo dnf -qy module disable postgresql`
</Highlight>

<!-- markdownlint-enable TS007 -->

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/
34 changes: 34 additions & 0 deletions _partials/_install-self-hosted-redhat.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@

import SelfHostedRedhatXPlatform from "versionContent/_partials/_install-self-hosted-redhat-x-platform.mdx";

<Procedure>

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 <<EOL
[timescale_timescaledb]
name=timescale_timescaledb
baseurl=https://packagecloud.io/timescale/timescaledb/el/$(rpm -E %{rhel})/\$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL
```

<SelfHostedRedhatXPlatform />


</Procedure>

[config]: /self-hosted/:currentVersion:/configuration/
51 changes: 51 additions & 0 deletions _partials/_install-self-hosted-rocky.md
Original file line number Diff line number Diff line change
@@ -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.

<Procedure>

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 <<EOL
[timescale_timescaledb]
name=timescale_timescaledb
baseurl=https://packagecloud.io/timescale/timescaledb/el/9/\$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL
```

1. **Disable the built-in PostgreSQL module**

This is for Rocky Linux 9 only.

```bash
sudo dnf module disable postgresql -y
```

<SelfHostedRocky />


</Procedure>

[config]: /self-hosted/:currentVersion:/configuration/
29 changes: 29 additions & 0 deletions _partials/_install-self-hosted-ubuntu.md
Original file line number Diff line number Diff line change
@@ -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";

<Procedure>

<SelfHostedDebianStart />

```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 -`

<SelfHostedDebianEnd />


</Procedure>


[config]: /self-hosted/:currentVersion:/configuration/
[releases-page]: https://packagecloud.io/timescale/timescaledb
Loading