Redash no Linux: Guia Completo de Instalação Docker

Na era da inteligência de dados, a capacidade de transformar consultas SQL brutas em insights visuais claros é uma competência crítica. Para equipes que priorizam a soberania dos dados e o controle total sobre sua infraestrutura, soluções de Business Intelligence (BI) self-hosted tornaram-se indispensáveis. O Redash emerge como uma ferramenta open source robusta, permitindo que desenvolvedores e analistas criem dashboards poderosos sem depender de plataformas SaaS caras ou com restrições de privacidade.

Este guia detalhado foca na redash linux instalação, especificamente utilizando o ambiente Ubuntu Server. Através deste tutorial, você aprenderá a configurar um ambiente completo para install redash ubuntu, integrando-o com bancos de dados SQL e NoSQL para criar visualizações de dados SQL eficazes. Ao final, você terá um self hosted bi tool operacional, pronto para democratizar o acesso aos dados na sua organização.

Pré-requisitos e Arquitetura do Sistema

Antes de iniciar a instalação, é fundamental entender a arquitetura do Redash. Ele não é uma aplicação monolítica; trata-se de um sistema distribuído que depende de vários componentes rodando simultaneamente. Para uma instalação funcional em produção ou desenvolvimento robusto, você precisará dos seguintes serviços:

• PostgreSQL: O banco de dados principal que armazena metadados do Redash (usuários, queries, dashboards).
• Redis: Utilizado para fila de tarefas e cache.
• Nginx: Servidor web reverso que gerencia o tráfego HTTPS/HTTP.
• Gunicorn: Gateway para a aplicação web Python (Frontend/API).
• Celery Workers: Processos assíncronos que executam as consultas SQL pesadas em segundo plano.

Você precisará de um servidor Ubuntu 20.04 ou 22.04 LTS com acesso root ou sudo, pelo menos 2GB de RAM (recomendável 4GB para produção) e conexão estável com a internet para baixar as dependências. Certifique-se também de que o firewall do servidor permita conexões na porta 80 (HTTP) e 443 (HTTPS), além da porta SSH.

Passo 1: Preparação do Ambiente Ubuntu

O primeiro passo em qualquer redash tutorial é garantir que o sistema operacional esteja atualizado e com as ferramentas básicas de compilação instaladas. Isso evita erros de dependências durante a instalação dos pacotes nativos.

sudo apt update && sudo apt upgrade -y
sudo apt install curl wget git python3 python3-pip python3-venv libffi-dev libssl-dev -y

Agora, vamos criar um usuário dedicado para rodar o Redash. Por segurança, nunca execute aplicações web complexas como root. Vamos chamar este usuário de redash.

sudo adduser --system --no-create-home --shell /bin/bash redash

Defina uma senha forte para este usuário (embora ele não tenha shell interativo por padrão, isso é bom prática) ou configure chaves SSH se for acessar remotamente. Em seguida, crie os diretórios onde o Redash será instalado e configurado.

sudo mkdir -p /opt/redash
sudo chown redash:redash /opt/redash

Passo 2: Instalação do PostgreSQL e Redis

O Redash requer um banco de dados relacional para armazenar sua configuração. O PostgreSQL é a escolha padrão e mais suportada. Vamos instalá-lo e configurá-lo.

sudo apt install postgresql postgresql-contrib redis-server -y
sudo systemctl enable postgresql
sudo systemctl enable redis-server
sudo systemctl start postgresql
sudo systemctl start redis-server

Agora, crie o banco de dados e o usuário específico para o Redash. Acesse o shell do PostgreSQL como o usuário postgres:

sudo -u postgres psql

Dentro do prompt do PostgreSQL, execute os seguintes comandos SQL:

CREATE USER redash WITH PASSWORD 'sua_senha_forte_aqui';
CREATE DATABASE redash OWNER redash;
\q

Substitua sua_senha_forte_aqui por uma senha complexa. Anote-a, pois você a usará na configuração posterior. Volte para o shell do Linux e verifique se o Redis está acessível:

redis-cli ping

Se a resposta for PONG, seu cache está pronto.

Passo 3: Instalação do Redash via Docker Compose

Embora existam métodos de instalação manual, a maneira mais padronizada, segura e fácil de manter para install redash ubuntu é utilizando o Docker e o Docker Compose. Isso garante que todas as dependências da aplicação (Python, Node.js) estejam isoladas e versionadas corretamente.

Instale o Docker Engine no seu servidor Ubuntu:

sudo apt install docker.io docker-compose -y
sudo systemctl enable docker
sudo systemctl start docker

Para evitar problemas de permissão, adicione o usuário redash ao grupo docker:

sudo usermod -aG docker redash

Agora, faça login como o usuário redash e baixe o repositório oficial do Redash. É recomendável usar uma versão específica (tag) para garantir estabilidade em produção.

sudo su - redash
cd /opt/redash
git clone https://github.com/getredash/redash.git .
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

Este comando baixa o código fonte e verifica a última tag de lançamento estável. Agora, precisamos configurar o arquivo .env, que controla todas as variáveis do sistema.

Passo 4: Configuração do Arquivo .env

O arquivo de ambiente é o coração da configuração. Vamos copiar o modelo e editá-lo:

cp env .env
nano .env

Você deve alterar as seguintes linhas no arquivo .env. Certifique-se de gerar uma chave secreta aleatória para segurança:

# Chave secreta para sessões e assinaturas JWT (gere uma aleatória)
REDASH_COOKIE_SECRET=gerar_uma_string_aleatoria_muito_longa_aqui
# Chave secreta para dados sensíveis (tabelas, conexões)
REDASH_SECRET_KEY=sua_senha_forte_do_banco_dados_aqui

# Configuração do Banco de Dados Backend
DATABASE_URL=postgresql://redash:sua_senha_forte_aqui@localhost/redash

# Configuração do Redis
REDIS_URL=redis://localhost:6379/0

# URL Pública do Redash (importante para redirecionamentos)
REDASH_BASE_URL=http://seu_dominio_ou_ip_do_servidor

# Executar workers em background
EXECUTE_QUERY_ON_SAVE=True

Dica de Segurança: Em produção, altere REDASH_BASE_URL para usar HTTPS e configure um certificado SSL via Nginx ou Let's Encrypt posteriormente. Para este tutorial, assumiremos HTTP local.

Passo 5: Inicialização do Banco de Dados

Antes de subir os containers, é necessário rodar as migrações do banco de dados para criar as tabelas iniciais necessárias pelo Redash. Isso deve ser feito uma única vez na primeira instalação.

docker-compose run --rm server db upgrade

Se o processo terminar sem erros, seu banco de dados está pronto e estruturado. Você verá mensagens confirmando a aplicação das migrações.

Passo 6: Inicialização dos Serviços

Agora, vamos iniciar todos os componentes do Redash. O Docker Compose gerenciará o início ordenado do PostgreSQL, Redis, Nginx, Gunicorn e Celery Workers.

docker-compose up -d

O sinal -d roda os containers em modo detached (background). Aguarde alguns segundos para que os serviços inicializem. Você pode verificar o status dos containers com:

docker-compose ps

Todos os serviços devem aparecer como Up. Se algum estiver falhando, verifique os logs:

docker-compose logs -f server

Acesse o navegador e vá para http://seu_ip_do_servidor. Você deverá ver a tela de login do Redash. A primeira conta criada será a conta de administrador.

Passo 7: Configuração Inicial e Primeiro Dashboard

Após o login, você será convidado a configurar sua conta. Vá em Admin Settings (Configurações de Administrador) no menu superior direito para gerenciar usuários e permissões.

Adicionando uma Fonte de Dados

O poder do Redash reside na sua capacidade de conectar-se a diversas fontes. Vamos adicionar um exemplo comum: um banco de dados SQL genérico ou MySQL.

1. Vá em Data Sources.
2. Clique em Add new data source.
3. Selecione o tipo do seu banco de dados (ex: MySQL, PostgreSQL, SQL Server).
4. Preencha os detalhes de conexão (Host, Port, User, Password).
5. Clique em Save.

O Redash testará a conexão. Se bem-sucedida, você poderá criar queries diretamente na interface.

Criando uma Query e Visualização

Clique em New Query. Escreva sua consulta SQL:

SELECT date_trunc('month', created_at) as month, count(*) as total_users
FROM users
GROUP BY month
ORDER BY month DESC;

Clique em Run Query. O Redash processará a query nos workers do Celery e retornará os resultados. Abaixo da tabela de resultados, clique em + Add visualization.

• Escolha o tipo de gráfico (ex: Bar Chart, Line Chart).
• Ajuste as configurações do gráfico.
• Clique em Save.

Por fim, salve a query e adicione-a a um Dashboard. Arraste os widgets para o layout desejado. Você agora tem um dashboard sql server ou SQL genérico funcional, totalmente self-hosted.

Otimização e Boas Práticas de Produção

Para uma instalação robusta que suporte múltiplos usuários concorrentes, considere as seguintes otimizações:

1. Configuração do Nginx com SSL

O Redash vem com um container Nginx básico. Para produção, é crucial configurar certificados SSL/TLS. Utilize Let's Encrypt para gerar certificados gratuitos e atualize o arquivo nginx.conf dentro do diretório de configuração do Redash ou monte um volume customizado com sua configuração de proxy reverso.

2. Escalabilidade dos Workers

Se você tiver muitas consultas pesadas, os workers podem ficar sobrecarregados. No arquivo .env, você pode ajustar o número de workers do Celery:

CELERY_CONCURRENCY=4

E aumentar a quantidade de containers de worker no docker-compose.yml (embora isso exija ajustes mais avançados na orquestração).

3. Backup Regular

Lembre-se que os dados críticos estão no PostgreSQL. Configure scripts de backup automáticos para o banco de dados redash. Os containers do Redash em si são efêmeros; a persistência deve estar no volume do banco de dados.

docker-compose exec db pg_dump -U redash redash > backup_redash_$(date +%F).sql

Conclusão

A redash linux instalação é um processo que, quando seguido passo a passo, resulta em uma ferramenta de análise de dados extremamente poderosa e flexível. Ao optar por um self hosted bi tool, sua equipe ganha controle total sobre a governança dos dados, custos previsíveis e integração profunda com seus sistemas internos.

Com o Redash rodando no Ubuntu, você está preparado para criar visualizações de dados SQL complexas, compartilhar insights com stakeholders e fomentar uma cultura data-driven na organização. Continue explorando as integrações disponíveis, desde APIs REST até bancos de dados NoSQL como MongoDB e Cassandra, expandindo o horizonte do seu open source analytics.

Para dúvidas específicas sobre configurações avançadas ou troubleshooting de conexões de banco de dados, consulte a documentação oficial do Redash. Lembre-se: uma boa instalação começa com uma boa configuração de ambiente.