This is a reference setup for Redash on a single Linux server.

It uses Docker and Docker Compose for deployment and management.

This is the same setup we use for our official images (for AWS & Google Cloud) and can be used as reference if you want to manually setup Redash in a different environment (different OS or different deployment location).

• setup.sh is the script that installs everything and creates the directories.
• compose.yaml is the Docker Compose setup we use.
• packer.json is Packer configuration we use to create the Cloud images.

• Alma Linux 8.x & 9.x
• CentOS Stream 9.x
• Debian 12.x
• Fedora 38, 39 & 40
• Oracle Linux 9.x
• Red Hat Enterprise Linux 8.x & 9.x
• Rocky Linux 8.x & 9.x
• Ubuntu LTS 20.04 & 22.04

This script should be run as the root user on a supported Linux system (as per above list):

# ./setup.sh

When run, the script will install the needed packages (mostly Docker) then install Redash, ready for you to configure and begin using.

The setup script has three optional parameters, --dont-start, --preview and --overwrite.

These can be used independently of each other, or with each other in any combination.

When the --preview parameter is given, the setup script will install the latest preview image from Docker Hub instead of using the last official release.

# ./setup.sh --preview

When the --overwrite option is given, the setup script will delete the existing Redash environment file (/opt/redash/env) and Redash database, then set up a brand new (empty) Redash installation.

# ./setup.sh --overwrite

When this option is given, the setup script will install Redash without starting it afterwards.

This is useful for people wanting to customise or modify their Redash installation before it starts for the first time.

# ./setup.sh --dont-start

For small scale deployments -- yes. But for larger deployments we recommend at least splitting the database (and probably Redis) into its own server (preferably a managed service like RDS) and setting up at least 2 servers for Redash for redundancy. You will also need to tweak the number of workers based on your usage patterns.

See Upgrade Guide.

You will need to create a docker installation function that suits your operating system, and maybe other functions as well.

The install_docker_*() functions in setup.sh shouldn't be too hard to adapt to other Linux distributions.

1. Stop the Redash containers and remove the images using docker compose -f /opt/redash/compose.yaml down --volumes --rmi all.

2. Remove the following lines from ~/.profile and ~/.bashrc if they're present.

   export COMPOSE_PROJECT_NAME=redash
   export COMPOSE_FILE=/opt/redash/compose.yaml
   

3. Delete the Redash folder using sudo rm -fr /opt/redash