Deploy to Scaleway
OpenReplay stack can be installed on a single instance and Scaleway Elements is an ideal candidate. Here's how to do it.
Launch an instance
- Go to Scaleway Dashboard
- Navigate to 'Compute > Instances' then click 'Create an instance'
- Choose your preferred Availability Zone
- Select an Image. For this guide, we'll be using Ubuntu Server 20.04 Focal Fossa
- Choose your instance type. The minimum specs are
2 vCPUs, 8 GB of RAM, 50 GB of storage, otherwise OpenReplay backend services won't simply start. So, we recommend at least the
DEV1-L(or an equivalent), which is enough for a low/moderate volume. If you're expecting high traffic, you should scale from here.
- Add Volumes: Set the size to at least 50 GB (whether local or block storage)
- Give your instance a sweet name (i.e. openreplay)
- SSH Keys: Make sure you already have a key associated with your project so you can connect to your instance
- Click 'Create a new instance'
Note: The SMTP ports (25, 465, 587) are blocked by default by Scaleway. Your OpenReplay instance won't be able to send emails unless you enable SMTP from your security group configuration. To do so, check this quick tutorial.
- Make sure your instance is
Startedthen connect to it:
## From your terminalSSH_KEY=~/Downloads/openreplay-key.pem #! wherever you've saved the SSH keyINSTANCE_IP=REPLACE_WITH_INSTANCE_PUBLIC_IPchmod 400 $SSH_KEYssh -i $SSH_KEY root@$INSTANCE_IP
- Install OpenReplay:
git clone https://github.com/openreplay/openreplay.gitcd openreplay/scripts/helm && bash install.sh
Note: You'll be prompted to provide the domain on which OpenReplay will be running (e.g. openreplay.mycompany.com). This is required to continue the installation.
OpenReplay deals with sensitive user data and therefore requires HTTPS to run. This is mandatory, otherwise the tracker simply wouldn't start recording. Same thing for the dashboard, without HTTPS you won't be able to replay user sessions.
You must therefore bring (or generate) your own SSL certificate.
First, go to 'Network' > 'DNS' (or your other DNS service provider) and create an
A Record. Use the domain you previously provided during the installation step and point it to the instance using its public IP (can be found in 'Compute' > 'Instances').
vars.yaml file with the command
vi openreplay/scripts/helm/vars.yaml then substitute:
domain_name: this is where OpenReplay will be accessible (i.e. openreplay.mycompany.com)
nginx_ssl_cert_file_path: the path to you .cert file (i.e. /root/openreplay/my-cert.crt)
nginx_ssl_key_file_path: the path to your .pem file (i.e. /root/openreplay/my-key.pem)
Note: If you don't have a certificate, generate one for your subdomain (the one provided during installation) using Let's Encrypt. Connect to OpenReplay instance, run
helm uninstall -n nginx-ingress nginx-ingressthen execute
bash openreplay/scripts/certbot.shand follow the steps.
Restart OpenReplay NGINX (and choose whether to enable the default HTTP to HTTPS redirection using the
cd openreplay/scripts/helmNGINX_REDIRECT_HTTPS=1 ./install.sh --app nginx
You're all set now, OpenReplay should be accessible on your subdomain. You can create an account by visiting the
/signup page (i.e. openreplay.mycompany.com/signup).
If you encounter any issues, connect to our Slack and get help from our community.