Alojar Ryot num VPS gerido é guardar o histórico do que vê, lê, joga e treina num servidor seu, que as nossas equipas mantêm atualizado e supervisionam dia e noite. O Ryot é uma aplicação de registo livre e de código aberto sob licença GPL-3.0, para filmes, séries, livros, jogos, podcasts, música e treinos. Este guia segue a sua imagem Docker oficial, na versão v10.5.8, e executámos cada comando num VPS Simafri antes de o escrever: a instalação com o Docker Compose e o PostgreSQL, o HTTPS, a primeira conta, as chaves de API de cada tipo de conteúdo, as cópias de segurança e as atualizações.
Por Simon Vasconcelos Lee
Publicado a 19 de novembro de 2026Leitura: 11 minutos
ignisda/ryot e o PostgreSQL 18, com a porta 8000 publicada em 127.0.0.1 atrás de um proxy inverso em HTTPS.SERVER_ADMIN_ACCESS_TOKEN num ficheiro .env, e defina FRONTEND_URL com o seu endereço público.USERS_ALLOW_REGISTRATION=false para fechar os registos numa instância privada.pg_dump e atualize alterando a etiqueta da imagem.O Ryot, de «Roll Your Own Tracker», que se pronuncia «riot», reúne num só sítio o que viu, leu, jogou e treinou, com estatísticas, um calendário do que aí vem e coleções suas. O seu criador, IgnisDa, escreve-o em Rust, com uma interface web que pode instalar num telemóvel como uma aplicação.
O Ryot é publicado sob a GNU General Public License, versão 3 (GPL-3.0). Pode utilizá-lo gratuitamente, para si, para a sua família, para o seu clube ou para a sua empresa, copiá-lo e modificá-lo. Se distribuir uma versão modificada, distribui o respetivo código-fonte sob a mesma licença. O software é fornecido sem garantia.
O Ryot Pro é uma chave paga vendida pelo seu criador, que desbloqueia funcionalidades adicionais, como a partilha de perfis e as recomendações personalizadas. Vai numa variável SERVER_PRO_KEY da mesma imagem, e o servidor regressa à versão comunitária se a chave expirar. Nada neste guia precisa dela.
A documentação não fixa nenhum tamanho mínimo, e o Ryot é leve. Eis o que medimos no nosso VPS de teste, acabado de instalar:
O tamanho do servidor depende, portanto, do número de utilizadores e das outras aplicações que executa ao lado do Ryot. Num VPS gerido, descreva-nos a sua utilização e recomendamos-lhe o tamanho adequado.
O Ryot é distribuído como uma única imagem, ignisda/ryot, publicada também como ghcr.io/ignisda/ryot, que serve ao mesmo tempo a interface e a API na porta 8000. Precisa do PostgreSQL 15 ou posterior, que funciona ao lado, no seu próprio contentor. Num servidor com o Docker Engine e o seu plugin Compose, instalados a partir do repositório do Docker para Ubuntu, crie uma pasta como /opt/ryot e coloque nela este compose.yaml, baseado no ficheiro da página de instalação:
services:
ryot-db:
image: postgres:18-alpine
restart: unless-stopped
environment:
- TZ=Europe/Amsterdam
- POSTGRES_DB=ryot
- POSTGRES_USER=ryot
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}
volumes:
- postgres_storage:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ryot -d ryot"]
interval: 5s
timeout: 5s
retries: 10
ryot:
image: ignisda/ryot:v10.5.8
restart: unless-stopped
ports:
- "127.0.0.1:8000:8000"
environment:
- TZ=Europe/Amsterdam
- FRONTEND_URL=https://ryot.example.com
- DATABASE_URL=postgres://ryot:${POSTGRES_PASSWORD}@ryot-db:5432/ryot
- SERVER_ADMIN_ACCESS_TOKEN=${SERVER_ADMIN_ACCESS_TOKEN:?set SERVER_ADMIN_ACCESS_TOKEN in .env}
depends_on:
ryot-db:
condition: service_healthy
volumes:
postgres_storage:
Os dois segredos vão para um ficheiro .env ao lado, que o Docker Compose lê sozinho. Crie-o legível apenas pelo root e depois arranque o conjunto:
umask 077
printf 'POSTGRES_PASSWORD=%s\nSERVER_ADMIN_ACCESS_TOKEN=%s\n' "$(openssl rand -hex 24)" "$(openssl rand -hex 32)" > .env
umask 022
docker compose up -d
docker compose ps
127.0.0.1: o ficheiro de referência publica-a sem endereço, e o Docker abre-a então em todos os endereços do servidor. Publicada localmente, só é acessível através do proxy inverso.postgres como utilizador e palavra-passe. Aqui, um utilizador dedicado ryot recebe uma palavra-passe aleatória, em hexadecimal para não precisar de nenhum escape em DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN é obrigatório: autoriza as operações de administrador através da API e cifra os segredos de autenticação de dois fatores dos seus utilizadores. Mantenha-o secreto e estável: com outro token, esses segredos deixam de poder ser lidos.FRONTEND_URL é o seu endereço público, com https://. O Ryot utiliza-o como base das ligações que gera, e o OpenID Connect precisa dele.TZ é o fuso horário das tarefas agendadas, GMT por omissão: indique o seu, da lista IANA.v10 com pull_policy: always, que segue cada versão menor em cada arranque. Uma versão completa, aqui v10.5.8, permite-lhe escolher o momento de cada atualização.postgres_storage contém todos os seus dados. O PostgreSQL 18 guarda-os em /var/lib/postgresql, e é por isso que o volume é montado aí e não em /var/lib/postgresql/data como nas versões anteriores.O primeiro arranque executa as migrações da base de dados e descarrega o catálogo de exercícios; no nosso VPS de teste, o Ryot respondeu em poucos segundos. Para verificar que responde:
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8000/health
curl -s http://127.0.0.1:8000/backend/config | head -c 300
O primeiro comando responde 200. O segundo devolve a configuração carregada pelo servidor, em JSON, com os segredos ocultados: uma forma prática de verificar uma variável.
O contentor serve o Ryot em HTTP, na porta 8000. O HTTPS fica a cargo de um proxy inverso colocado à frente, que deve transmitir o cabeçalho Host público e X-Forwarded-Proto. Testámos o Caddy, instalado a partir do seu repositório oficial para Debian e Ubuntu: obtém sozinho o certificado Let’s Encrypt, renova-o, e transmite estes cabeçalhos por omissão.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.O Ryot não tem conta por omissão, e os registos estão abertos numa instância nova. A primeira conta criada recebe a função Admin; as seguintes são utilizadores normais. Crie a sua logo após o primeiro arranque:
Para uma instância privada, feche os registos: acrescente USERS_ALLOW_REGISTRATION=false ao ambiente do serviço ryot e depois execute docker compose up -d. No nosso VPS de teste, a ligação «Create a new account?» desapareceu, e uma tentativa de registo a partir do endereço de registo foi recusada pelo servidor com «Registration is disabled».
Testámos com os registos fechados: a conta convidada foi criada como utilizador normal, a sua palavra-passe foi definida a partir da ligação, e chegou ao seu próprio painel.
Para iniciar sessão com as contas da sua empresa, o Ryot suporta o OpenID Connect: defina SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET e SERVER_OIDC_ISSUER_URL, e declare https://ryot.example.com/api/auth como endereço de redirecionamento no seu fornecedor.
O Ryot obtém os detalhes e as capas de cada tipo de conteúdo junto de um fornecedor. Alguns funcionam sem chave, outros precisam da sua, já que as chaves partilhadas foram retiradas na v9:
| Conteúdo | Fornecedor | O que definir |
|---|---|---|
| Livros | Open Library | Nada: funciona de imediato. O Google Books e o Hardcover são opcionais, com a respetiva chave de API |
| Filmes e séries | TMDB, ou TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, o API Read Access Token de uma conta TMDB gratuita, ou MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videojogos | IGDB, através da Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID e VIDEO_GAMES_TWITCH_CLIENT_SECRET, de uma aplicação na consola de programadores da Twitch |
| Música | Spotify, opcional | MUSIC_SPOTIFY_CLIENT_ID e MUSIC_SPOTIFY_CLIENT_SECRET |
| Importação de anime | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, necessário apenas para importar do MyAnimeList |
Estas chaves são segredos: coloque-as no ficheiro .env, acrescente uma linha como - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} ao ambiente do serviço ryot e depois execute docker compose up -d. A página de configuração da documentação enumera todas as outras variáveis.
Tudo se encontra em dois sítios: a base de dados PostgreSQL, no volume postgres_storage, e o seu ficheiro .env. Guarde este último em segurança: SERVER_ADMIN_ACCESS_TOKEN é necessário para ler os segredos de dois fatores guardados na base de dados. A imagem do PostgreSQL inclui pg_dump. O dump contém todas as contas e o respetivo histórico, por isso crie-o legível apenas pelo root, com umask 077 entre parênteses: o resto da sua sessão mantém a máscara habitual. Um ficheiro que já existe mantém as suas permissões quando é substituído, por isso a linha find fecha primeiro os dumps e as cópias que já estão na pasta, antes de qualquer escrita, e interrompe a cópia de segurança se não o conseguir:
(
umask 077
find . -maxdepth 1 \( -name 'ryot-*.dump' -o -name 'env-*.bak' \) -exec chmod 600 {} + || exit 1
docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot > ryot-$(date +%F).dump
cp .env env-$(date +%F).bak
)
Programe esta cópia e envie-a para fora do servidor. Guardados no disco, os dumps entram também nas cópias de segurança noturnas do servidor.
Na mesma instalação ou numa nova, com o mesmo .env, pare a aplicação, substitua a base de dados por uma vazia, carregue nela o dump e volte a arrancar a aplicação:
docker compose stop ryot &&
docker compose exec -T ryot-db dropdb -U ryot ryot &&
docker compose exec -T ryot-db createdb -U ryot ryot &&
docker compose exec -T ryot-db pg_restore -U ryot -d ryot --exit-on-error --no-owner < ryot-2026-11-20.dump &&
docker compose start ryot
--exit-on-error interrompe o restauro no primeiro erro, em vez de continuar e indicar os erros no fim, e os && interrompem aí a sequência: o Ryot fica parado. O que foi carregado antes do erro permanece na base de dados, por isso recomece a partir de dropdb depois de corrigida a causa.Testámos o ciclo completo no nosso VPS com estes mesmos comandos: dump, base de dados apagada e criada de novo vazia, restauro. As duas contas, as suas coleções e os 876 exercícios voltaram, e o administrador iniciou sessão de novo de imediato.
O Ryot exporta também os seus próprios dados em JSON, a partir da página de definições «Imports and Exports», e consegue voltar a importá-los. Essa exportação precisa de um armazenamento de ficheiros compatível com S3; o dump da base de dados acima funciona sem ele.
O Ryot lança versões com frequência, mais ou menos todas as semanas. Leia a nota de versão, faça uma cópia de segurança, altere a etiqueta da imagem no compose.yaml, e depois obtenha a nova imagem e recrie o contentor. As migrações da base de dados são executadas sozinhas no arranque:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop segue o ramo principal: a documentação avisa que tem muitas vezes erros graves e pode perder dados. Mantenha-se nas versões publicadas.O Ryot recolhe dados de utilização anónimos, páginas vistas e alguns eventos, numa instância Umami autoalojada pelo seu criador. Para a desativar, acrescente DISABLE_TELEMETRY=true ao ambiente do serviço ryot e depois execute docker compose up -d.
O autoalojamento exige cuidar do servidor para além da aplicação. Num VPS gerido, as nossas equipas assumem o servidor e acompanham a sua instância de forma proativa; o Ryot continua a ser o seu software, com o seu histórico e as suas definições.
| Assunto | As nossas equipas | Você |
|---|---|---|
| O servidor | Atualizações do sistema e de segurança, intervenções no servidor incluídas | O momento que lhe convém |
| A supervisão | Servidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar pela sua chamada | O seu histórico, as suas coleções e as suas integrações no Ryot |
| Ryot | Acompanhamento proativo: erros, lentidão, base de dados e espaço em disco identificados, correção recomendada | A sua instalação, as suas atualizações, as suas chaves de API e as suas definições, que aplica diretamente ou com o seu assistente de IA |
| Os utilizadores | O servidor que os suporta, vigiado e com cópias de segurança | As contas, os registos e o início de sessão único |
| As cópias de segurança | Todas as noites, cifradas e guardadas fora da máquina; restauro incluído | Os dumps da base de dados e as exportações JSON próprios do Ryot e o pedido de restauro, quando precisar |
| A migração | O seu servidor atual migrado, oferecido | O momento da mudança |
Se preferir que as nossas equipas intervenham na própria aplicação, este serviço é faturado à hora ou por pacote, com um orçamento comunicado antes da intervenção.
Com um VPS gerido da Simafri, as nossas equipas mantêm atualizado o servidor da sua instância Ryot, vigiam-no dia e noite e intervêm sem esperar pela sua chamada; acompanham também a sua instância de forma proativa e recomendam-lhe as correções úteis, que aplica diretamente ou com o seu assistente de IA. As cópias de segurança são cifradas todas as noites e guardadas fora da máquina, o seu restauro está incluído, e a migração do seu servidor atual é oferecida.
Sim. O Ryot está sob licença GPL-3.0: pode executá-lo para si, para a sua família ou para a sua equipa sem licença para comprar. O Ryot Pro é uma chave paga opcional que acrescenta funcionalidades à mesma imagem. Resta o custo do servidor que o faz funcionar.
Utilize a imagem ignisda/ryot e o PostgreSQL 18 num compose.yaml. Coloque a palavra-passe da base de dados e SERVER_ADMIN_ACCESS_TOKEN num ficheiro .env, defina FRONTEND_URL com o seu endereço https, publique a porta 8000 em 127.0.0.1, execute docker compose up -d e coloque à frente um proxy inverso em HTTPS.
Não existem. Clique em «Create a new account?» na página de início de sessão: a primeira conta criada torna-se a do administrador. Depois, defina USERS_ALLOW_REGISTRATION=false para fechar os registos; o administrador convida os outros utilizadores a partir de Settings, Users, com uma ligação de utilização única.
Desde a v9, os filmes e as séries precisam do seu próprio token do TMDB: crie uma conta TMDB gratuita, peça uma chave de API e coloque o respetivo API Read Access Token em MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Os videojogos precisam de uma aplicação Twitch, enquanto os livros funcionam sem nenhuma chave.
Pouca. No nosso VPS de teste, uma instalação nova utilizava cerca de 240 a 300 MB para o Ryot e 70 MB para o PostgreSQL, e as duas imagens ocupam cerca de 810 MB de disco.
Faça o dump da base de dados PostgreSQL com docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot sob umask 077, para que só o root o possa ler, e guarde uma cópia do seu ficheiro .env. Para restaurar, pare a aplicação, recrie a base de dados vazia com dropdb e createdb, e depois carregue o dump com pg_restore --exit-on-error --no-owner.
Leia a nota de versão e faça uma cópia de segurança, altere a etiqueta da imagem no compose.yaml, e depois execute docker compose pull e docker compose up -d. As migrações da base de dados são executadas sozinhas no arranque. Entre versões principais, siga a página de migração.
Um VPS gerido cobre o servidor: sistema, segurança, supervisão e cópias de segurança. As nossas equipas acompanham também a sua instância de forma proativa e recomendam-lhe as correções úteis, que aplica. Uma intervenção na aplicação é faturada à hora ou por pacote.
Simafri
Vamos falar do seu projeto
Diga-nos em poucas palavras o que precisa: respondemos-lhe rapidamente.
Obrigado! O seu pedido foi enviado. Responderemos em breve.
Prefere o email? Escreva-nos para support@simafri.com.