Instalação Radicale · 7 min read · Sep 08, 2025

Como Instalar o Radicale Calendar (CalDAV e CardDAV) no Ubuntu 20.04

Radicale é um servidor CalDAV (Calendários, listas de tarefas) e CardDav (contatos) gratuito e de código aberto. Ele visa ser uma aplicação de servidor pequena e leve (CalDAV e CardDav), mas poderosa e que funciona imediatamente. O Radicale permite que você compartilhe calendários e listas de contatos através de CalDAV, CardDAV e HTTPS. E o mais importante, ele pode ser seguro através de conexão TLS e autenticação. Além disso, funciona com muitos clientes CalDAV e CardDAV, como gnome-calendar, evolution, Mozilla thunderbird, DAVx (para android), etc.

O Radicale vem com uma configuração simples, e é fácil de configurar e instalar. O Radicale é escrito em Python e roda em sistemas operacionais como Linux, BSD, macOS e Windows.

Neste tutorial, você aprenderá como instalar e configurar o Radicale no Ubuntu 20.04.

Pré-requisitos

  • Um Ubuntu 20.04. Certifique-se de que os pacotes e repositórios estão atualizados.
  • Um usuário root ou usuário com privilégios de root. Isso será usado para instalar novos pacotes e editar a configuração do sistema.

Instalando a Biblioteca Passlib e Bcrypt

No início, você instalará algumas dependências de pacotes para a instalação do radicale. Você instalará o python-pip, o módulo python-passlib e, em seguida, instalará o módulo python bcrypt do PyPI (repositório python).

  1. Execute o seguinte comando apt para instalar o python-pip e o módulo python-passlib no sistema Ubuntu.
sudo apt install python3-pip python3-passlib

Digite ‘ Y ‘ e pressione ‘ Enter ‘ para instalar todos esses pacotes.

Instalar Python Pip e Biblioteca Passlib

  1. Se a instalação estiver completa, execute o comando pip abaixo para instalar o módulo Python bcrypt.
sudo pip3 install bcrypt

Agora você verá a seguinte saída.

Instalar biblioteca Bcrypt

Instalando e Configurando o Radicale

Por padrão, os pacotes radicale estão disponíveis no repositório do Ubuntu.

  1. Execute o comando apt abaixo para instalar o radicale no sistema Ubuntu.
sudo apt install radicale

Digite ‘ Y ‘ e pressione ‘ Enter ‘ para instalar os pacotes radicale.

Instalar Calendário Radicale no Ubuntu

  1. Após a instalação ser concluída, você editará a configuração padrão do radicale que está disponível em ‘ /etc/radicale/config ‘.

Edite a configuração radical usando o comando nano abaixo.

sudo nano /etc/radicale/config
  1. Na seção [server], altere a configuração padrão usando a seguinte configuração.
[server]  
  
host = 127.0.0.1:5232  
max_connections = 20  
max_content_length = 100000000  
timout = 30

O servidor radicale estará rodando apenas no endereço IP local porque colocaremos o servidor web Apache como um proxy reverso na frente dele.

  1. Em seguida, comente a configuração SSL como abaixo, porque a criptografia SSL será feita através do proxy reverso Apache.
# Sinalizador SSL, habilitar protocolo HTTPS  
#ssl = False  
  
# Caminho do certificado SSL  
#certificate = /etc/ssl/certs/ssl-cert-snakeoil.pem  
  
# Chave privada SSL  
#key = /etc/ssl/private/ssl-cert-snakeoil.key
  1. Depois disso, vá para a seção ‘[auth]’ e altere a configuração padrão da seguinte forma.
[auth]  
type = htpasswd  
htpasswd_filename = /etc/radicale/users  
htpasswd_encryption = bcrypt

O tipo de autenticação que estamos usando é ‘ htpasswd ‘ com a forte criptografia ‘ bcrypt ‘, e uma lista de usuários será armazenada no arquivo ‘ /etc/radicale/users ‘.

  1. Em seguida, na configuração inferior, você verá a seção ‘[storage] ‘. Altere a configuração como abaixo para habilitar o backend de armazenamento do radicale.
[storage]  
type = multifilysystem  
filesystem_folder = /var/lib/radicale/collections  
filesystem_locking = True

O backend de armazenamento padrão para o radicale é ‘multifilesystem’, e todos os dados dos usuários estão disponíveis no diretório ‘/var/lib/radicale/collections’.

Agora pressione ‘ Ctrl+x ‘ e digite ‘y’, em seguida, pressione o botão ‘ Enter ‘ para salvar e sair.

Gerar Usuários para Radicale

Neste estágio, a configuração do radicale está concluída. E por agora, você criará um novo usuário e senha para o radicale, que pode ser gerado usando o comando ‘htpasswd’ (parte do pacote ‘apache2-utils’).

  1. Execute o comando apt abaixo para instalar o pacote ‘ apache2-utils ‘.
sudo apt install apache2-utils

Digite ‘ Y ‘ e pressione ‘ Enter ‘ para continuar a instalação.

Instalar pacote Apache utils

  1. Em seguida, gere um novo usuário (neste exemplo, o usuário é ‘johndoe’) e senha executando o comando htpasswd abaixo.
sudo htpasswd -B -c /etc/radicale/users johndoe

Agora digite e repita a senha para o usuário ‘ johndoe ‘.

Opções importantes que você deve conhecer:

  • -B option - isso forçará o uso da forte criptografia ‘bcrypt’, não o padrão ‘md5’.
  • -c option - O arquivo de senha que você deseja criar. Nome de usuário e senhas estão disponíveis nesse arquivo.

Para adicionar outro usuário, basta executar o comando acima e alterar o nome de usuário pelo seu.

Opcionalmente, verifique o arquivo de senha gerado ‘ /etc/radicale/users ‘ usando o comando cat como abaixo.

cat /etc/radicale/users

Gerar usuários htpasswd e senha

  1. Após gerar o arquivo de usuário e senha, habilite o serviço radicale para iniciar automaticamente na inicialização.
sudo systemctl enable radicale
  1. Agora inicie o serviço radicale e verifique o status do serviço executando o seguinte comando.
sudo systemctl start radicale  
sudo systemctl status radicale

Se o seu serviço radicale estiver ativo e em execução, você verá uma saída semelhante à abaixo. Caso contrário, você verá o status do serviço radicale como ‘failed’ na parte inferior das mensagens de log.

Iniciar e verificar status do serviço radicale

Configurar o Apache como um Proxy Reverso para Radicale

Neste estágio, você instalará e configurará o Apache como um proxy reverso para o radicale.

  1. Instale os pacotes Apache executando o comando apt abaixo.
sudo apt install apache2

Agora digite ‘ Y ‘ e pressione ‘ Enter ‘ para continuar a instalação.

Instalar Servidor Web Apache

  1. Após a instalação ser concluída, execute o seguinte comando para habilitar alguns módulos de proxy para o Apache e habilitar o módulo mod_ssl.
sudo a2enmod proxy proxy_ajp proxy_http rewrite deflate headers proxy_balancer proxy_connect proxy_html ssl
  1. Agora mude o diretório de trabalho para ‘ /etc/apache2/sites-available ‘ e crie uma nova configuração de host virtual ‘ radicale.conf ‘.
cd /etc/apache2/sites-available/  
sudo nano radicale.conf

Copie e cole a seguinte configuração e certifique-se de alterar o nome do domínio pelo seu.

  
       
    ServerName cal.domain-name.io  
    ServerAdmin [email protected]  
  
    ErrorLog ${APACHE_LOG_DIR}/cal-dmain-name.io.error.log  
    CustomLog ${APACHE_LOG_DIR}/cal-dmain-name.io.access.log combined  
  
    ProxyRequests Off  
      
        Order deny,allow  
        Allow from all  
      
  
    RewriteEngine On  
    RewriteRule ^/radicale$ /radicale/ [R,L]  
  
      
        AuthType     Basic  
        AuthName     "Radicale - Senha Necessária"  
        AuthUserFile "/etc/radicale/users"  
        Require      valid-user  
  
        ProxyPass        http://localhost:5232/ retry=0  
        ProxyPassReverse http://localhost:5232/  
        RequestHeader    set X-Script-Name /radicale  
        RequestHeader    set X-Remote-User expr=%{REMOTE_USER}  
      
  
      
        Order allow,deny  
        Allow from all  
      
  

Salve a configuração pressionando ‘ Ctrl+x ‘ e digite ‘ y ‘, em seguida, pressione ‘ Enter ‘.

Usando esta configuração, o radicale estará disponível no caminho do domínio ‘domain.com/radicale’, não na raiz do nome do domínio.

  1. Em seguida, execute o seguinte comando para ativar a configuração do host virtual ‘radicale.conf’.
sudo a2ensite radicale.conf
  1. Depois disso, verifique a configuração do Apache e certifique-se de que não há erro, em seguida, reinicie o serviço Apache para aplicar a nova configuração do host virtual.
sudo apachectl configtest  
sudo systemctl restart apache2

Se a sua configuração do Apache estiver correta, você verá a mensagem ‘ Syntax OK ‘ após executar o comando ‘apachectl’. E abaixo está a saída semelhante que você obterá.

Configurando Host Virtual Apache para Radicale

Gerar SSL Letsencrypt

Para esta etapa, você estará segurando a instalação do radicale usando o SSL Letsencrypt.

  1. Execute o seguinte comando para instalar o certbot e o plugin certbot-apache.
sudo apt install certbot python-certbot-apache
  1. Após a instalação ser concluída, gere um novo SSL Letsencrypt para o nome de domínio radicale usando o comando certbot abaixo.
sudo certbot --apache -d domain-name.io -d www.domain-name.io

E você será solicitado a algumas perguntas abaixo.

  • Um endereço de e-mail: quando o certificado SSL expirar, você será notificado por este e-mail.
  • TOS (Termos de Serviço) do Letsencrypt: digite ‘ A ‘ para concordar.
  • Compartilhar e-mail com EFF: você pode escolher ‘ N ‘ para não.
  • Redirecionar automaticamente HTTP para HTTPS: escolha o número ‘2’ para habilitar o redirecionamento automático.

Uma vez que o processo esteja completo, você verá que os certificados SSL estão disponíveis no diretório ‘/etc/letsencrypt/live/domain.com’. E o host virtual do Apache foi alterado com configuração adicional do letsencrypt.

Verificar Instalação

Abra seu navegador e digite a URL de instalação do radicale na barra de endereços.

https://cal.domain-name.io/radicale/

Agora você será solicitado a inserir o usuário e a senha para a autenticação básica do Apache.

Autenticação Básica do Radicale Apache

Digite seu usuário e senha, em seguida, clique no botão ‘ Entrar ‘.

E você verá a página de login do Radicale abaixo.

Página de login do Radicale

Digite seu usuário e senha para Radicale e clique no botão ‘ Próximo ‘.

Uma vez que você tenha feito login, clique no link ‘ Criar um novo catálogo ou calendário ‘.

Criar novo calendário

Altere o título, descrição, tipo e cor com os seus, em seguida, clique no botão ‘ Criar ‘.

Criar novo calendário

Agora você será redirecionado para o painel do usuário radicale abaixo.

Painel do usuário Radicale

Conclusão

Parabéns! Agora você instalou com sucesso o Radicale no Servidor Ubuntu 20.04. Para a próxima etapa, você pode se conectar ao seu novo servidor radicale de forma segura usando os clientes CalDAV/CardDAV do seu computador ou smartphone Android.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.