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).
- 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-passlibDigite ‘ Y ‘ e pressione ‘ Enter ‘ para instalar todos esses pacotes.

- Se a instalação estiver completa, execute o comando pip abaixo para instalar o módulo Python bcrypt.
sudo pip3 install bcryptAgora você verá a seguinte saída.

Instalando e Configurando o Radicale
Por padrão, os pacotes radicale estão disponíveis no repositório do Ubuntu.
- Execute o comando apt abaixo para instalar o radicale no sistema Ubuntu.
sudo apt install radicaleDigite ‘ Y ‘ e pressione ‘ Enter ‘ para instalar os pacotes radicale.

- 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- 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 = 30O servidor radicale estará rodando apenas no endereço IP local porque colocaremos o servidor web Apache como um proxy reverso na frente dele.
- 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- 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 = bcryptO 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 ‘.
- 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 = TrueO 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’).
- Execute o comando apt abaixo para instalar o pacote ‘ apache2-utils ‘.
sudo apt install apache2-utilsDigite ‘ Y ‘ e pressione ‘ Enter ‘ para continuar a instalação.

- 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 johndoeAgora 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
- 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- Agora inicie o serviço radicale e verifique o status do serviço executando o seguinte comando.
sudo systemctl start radicale
sudo systemctl status radicaleSe 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.

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.
- Instale os pacotes Apache executando o comando apt abaixo.
sudo apt install apache2Agora digite ‘ Y ‘ e pressione ‘ Enter ‘ para continuar a instalação.

- 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- 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.confCopie 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.
- Em seguida, execute o seguinte comando para ativar a configuração do host virtual ‘radicale.conf’.
sudo a2ensite radicale.conf- 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 apache2Se 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á.

Gerar SSL Letsencrypt
Para esta etapa, você estará segurando a instalação do radicale usando o SSL Letsencrypt.
- Execute o seguinte comando para instalar o certbot e o plugin certbot-apache.
sudo apt install certbot python-certbot-apache- 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.ioE 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.

Digite seu usuário e senha, em seguida, clique no botão ‘ Entrar ‘.
E você verá a página de login do Radicale abaixo.

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 ‘.

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

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

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.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.