Skip to content

native-installation.md

Latest commit

 

History

History
68 lines (47 loc) · 2.92 KB

native-installation.md

File metadata and controls

68 lines (47 loc) · 2.92 KB
description Detailed instructions on setting up a native RudderStack installation

Native Installation

{% hint style="warning" %} This is not the easiest way of installing RudderStack. Please use this method only if you want to know more about the RudderStack internals. {% endhint %}

Please follow these steps to set up a native installation of RudderStack:

createdb jobsdb
createuser --superuser rudder
psql "jobsdb" -c "alter user rudder with encrypted password 'rudder'";
psql "jobsdb" -c "grant all privileges on database jobsdb to rudder";
  • Go to the RudderStack dashboard and set up your account. Copy your workspace token from the top of the home page.
  • Create a directory for the RudderStack server using the following command:
mkdir rudder-server
  • Go to the RudderStack server page and download the latest binary for your target system. Then, move it to the rudder-server directory.
  • Create a directory for the RudderStack transformer using the following command:
mkdir rudder-transformer
  • Go to the RudderStack transformer page and download the latest release package. Then, extract it in the rudder-transformer directory.
  • Navigate to the transformer directory using the following command:
cd rudder-transformer
  • Install the dependencies using the command npm i . Then, start the destination transformer using the following command:
node destTransformer.js
  • Navigate back to the main directory using the command cd rudder-server. Then, create a .env file, and copy the contents of the file sample.env into the previously created .env file.
  • Update theWORKSPACE_TOKEN environment variable with the token fetched from your RudderStack dashboard.
  • Run the backend server using the following command:
./rudder-server

{% hint style="info" %} Once you have successfully followed the steps above, follow our guide on How to Send Test Events in order to test if there are any issues with the installation. {% endhint %}

Contact Us

If you come across any queries or issues while setting up your native RudderStack installation, please feel free to contact us. You can also start a conversation on our Slack channel.