Linux
This page explains the steps required to setup systemd service for Parseable server in both S3 or local store mode.
Setup Parseable with Local Storage
The local store mode is recommended for testing purposes only. For production use, we recommend using S3 storage.
Prerequisites
- Parseable binary available at
/usr/local/bin/. Download the relevant binary from the release page.
Create configuration
cat <<EOT >> /etc/default/parseable
P_USERNAME="parseable"
P_PASSWORD="parseable"
P_ADDR="0.0.0.0:8000"
P_STAGING_DIR="/var/lib/parseable/staging"
P_FS_DIR="/var/lib/parseable/data"
EOT
Download parseable.local.service in /etc/systemd/system/
( cd /etc/systemd/system/; curl -O https://raw.githubusercontent.com/parseablehq/parseable/main/systemd/parseable.local.service )
Start/Stop the service
Once the service file is created, reload the systemd daemon and start the service.
systemctl enable parseable.local.service
service parseable start
You can check the status of the service using the following command.
service parseable status
You can now access Parseable at the address http://localhost:8000 (default configuration). If you added P_ADDR in config file, please access the correct URL accordingly.
To check logs, use journalctl, like this.
journalctl -eu parseable.local.service
In case you want to disable / uninstall Parseable, run the below command.
systemctl disable parseable.local.service
Setup Parseable with S3 Storage
Prerequisites
- Parseable binary available at
/usr/local/bin/. Download the relevant binary from the release page. - S3 or compatible object store URL, access key and secret key and bucket name to be used as the storage.
Create configuration
Please ensure to replace the placeholders with the relevant values.
cat <<EOT >> /etc/default/parseable
P_USERNAME=<username>
P_PASSWORD=<password>
P_ADDR="0.0.0.0:8000"
P_STAGING_DIR="/var/lib/parseable/staging"
P_S3_BUCKET=<s3-bucket>
P_S3_ACCESS_KEY=<access-key>
P_S3_SECRET_KEY=<secret-key>
P_S3_REGION=<region>
P_S3_URL=<s3-url>
EOT
Download parseable.s3.service in /etc/systemd/system/
( cd /etc/systemd/system/; curl -O https://raw.githubusercontent.com/parseablehq/parseable/main/systemd/parseable.s3.service )
Start/Stop the service
Once the service file is created, reload the systemd daemon and start the service.
systemctl enable parseable.s3.service
service parseable start
You can check the status of the service using the following command.
service parseable status
You can now access Parseable at the address http://localhost:8000 (default configuration). If you added P_ADDR in config file, please access the correct URL accordingly.
In case you want to disable / uninstall Parseable, run the below command.
systemctl disable parseable.s3.service