Skip to content

Latest commit

 

History

History
62 lines (54 loc) · 3.03 KB

README.md

File metadata and controls

62 lines (54 loc) · 3.03 KB
Raw

Deploy Self-Hosted Redash using Dokku

Before you're doing this...

If you are using AWS EC2, DigitalOcean, or Google Compute Engine, it's better to use the prebuilt image which you can see the guide in the Redash Self-Hosted Guide. If you are not using one of those, you may continue.

Requirements

  1. A fresh installation of Ubuntu 18.04/20.04 x64, Debian 9+ x64 or CentOS 7 x64 (experimental) with the FQDN set
  2. 4GB of RAM (More RAM means more Workers)
  3. Dokku
  4. Postgres
  5. Redis
  6. Redash
  7. Patience

How-to steps

  1. Install Dokku by following the Dokku's Getting Started Guide
  2. After Dokku has been installed, create an app called redash by running dokku apps:create redash
  3. Install Dokku Postgres and Dokku Redis by running this commands below: 
    sudo dokku plugin:install https://github.com/dokku/dokku-postgres.git postgres
sudo dokku plugin:install https://github.com/dokku/dokku-redis.git redis
  4. Create a Postgres instance by running dokku postgres:create postgres
  5. Create a Redis instance by running dokku redis:create redis
  6. Link the created Postgres and Redis instance by runnning this commands below: 
    # This will link postgres instance to redash app
dokku postgres:link postgres redash
# This will link redis instance to redash app
dokku redis:link redis redash
  7. Run dokku config:show redash and copy the DATABASE_URL and REDIS_URL to somewhere else
  8. Add new environment variables to the redash app by running this command: 
    dokku config:set redash REDASH_DATABASE_URL=<your previously copied DATABASE_URL>
dokku config:set redash REDASH_REDIS_URL=<your previously copied REDIS_URL>
dokku config:set redash DOKKU_PROXY_PORT_MAP=http:80:5000
  9. Set other Redash required environment variables by running this command: 
    dokku config:set redash <VARIABLE_NAME>=<YOUR_VALUE>
  10. Clone this repository to your local computer
  11. After you clone this repository, add a new git remote called dokku to your Dokku instance by running: 
    git remote add dokku dokku@<your_dokku_ip/your_dokku_domain>:redash
  12. Push to dokku remote by running git push dokku master (Heads up: Dokku only listens for deployment via master, so if you're deploying from main, you need to change your command to git push dokku main:master)
  13. After pushing to Dokku, go to your Dokku instance terminal and run this commands below: 
    dokku ps:scale redash web=1 scheduler=1 worker=4
  14. Open your Dokku instance by your IP/Domain and proceed with installing Redash.
  15. Congratulations!

Migrating Data from redash.io to Self Hosted Redash

See the instructions for their migration tool. If you have questions please post on their user forum.