Hospedar Ryot em um VPS gerenciado é guardar o histórico do que você assiste, lê, joga e treina em um servidor próprio, que nossas equipes mantêm atualizado e supervisionam dia e noite. O Ryot é um aplicativo de registro livre e de código aberto sob a licença GPL-3.0, para filmes, séries, livros, jogos, podcasts, música e treinos. Este guia segue a imagem Docker oficial dele, na versão v10.5.8, e executamos cada comando em um VPS Simafri antes de escrevê-lo: a instalação com Docker Compose e PostgreSQL, o HTTPS, a primeira conta, as chaves de API de cada tipo de mídia, os backups e as atualizações.
Por Simon Vasconcelos Lee
Publicado em 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 reverso em HTTPS.SERVER_ADMIN_ACCESS_TOKEN em um arquivo .env, e defina FRONTEND_URL com seu endereço público.USERS_ALLOW_REGISTRATION=false para fechar os cadastros em uma instância privada.pg_dump e atualize trocando a tag da imagem.O Ryot, de “Roll Your Own Tracker”, pronunciado “riot”, reúne em um só lugar o que você assistiu, leu, jogou e treinou, com estatísticas, um calendário do que está por vir e coleções próprias. O desenvolvedor dele, IgnisDa, o escreve em Rust, com uma interface web que pode ser instalada em um celular como um aplicativo.
O Ryot é publicado sob a GNU General Public License, versão 3 (GPL-3.0). Você pode usá-lo gratuitamente, para você, sua família, seu clube ou sua empresa, copiá-lo e modificá-lo. Se você distribuir uma versão modificada, distribui o código-fonte dela sob a mesma licença. O software é fornecido sem garantia.
O Ryot Pro é uma chave paga vendida pelo desenvolvedor, que libera recursos extras, como o compartilhamento de perfis e as recomendações personalizadas. Ela vai em uma variável SERVER_PRO_KEY da mesma imagem, e o servidor volta à versão comunitária se a chave expirar. Nada neste guia precisa dela.
A documentação não define nenhum tamanho mínimo, e o Ryot é leve. Veja o que medimos em nosso VPS de teste, recém-instalado:
O tamanho do servidor depende, portanto, do número de usuários e dos outros aplicativos que você roda ao lado do Ryot. Em um VPS gerenciado, conte-nos como você usa o aplicativo e recomendaremos o tamanho certo.
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. Ele precisa do PostgreSQL 15 ou posterior, que roda ao lado, em seu próprio contêiner. Em um servidor com o Docker Engine e o plugin Compose dele, instalados a partir do repositório do Docker para Ubuntu, crie uma pasta como /opt/ryot e coloque nela este compose.yaml, baseado no arquivo 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 em um arquivo .env ao lado, que o Docker Compose lê sozinho. Crie-o legível apenas pelo root e depois inicie 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 arquivo de referência a publica sem endereço, e o Docker a abre então em todos os endereços do servidor. Publicada localmente, ela só é acessível pelo proxy reverso.postgres como usuário e senha. Aqui, um usuário dedicado ryot recebe uma senha aleatória, em hexadecimal para não precisar de nenhum escape em DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN é obrigatório: ele autoriza as operações de administrador pela API e criptografa os segredos de autenticação de dois fatores de seus usuários. Mantenha-o em segredo e estável: com outro token, esses segredos não podem mais ser lidos.FRONTEND_URL é seu endereço público, com https://. O Ryot o usa como base dos links que gera, e o OpenID Connect precisa dele.TZ é o fuso horário das tarefas agendadas, GMT por padrão: coloque seu fuso, da lista IANA.v10 com pull_policy: always, que segue cada versão menor a cada inicialização. Uma versão completa, aqui v10.5.8, permite escolher o momento de cada atualização.postgres_storage guarda todos os seus dados. O PostgreSQL 18 os mantém em /var/lib/postgresql, e é por isso que o volume é montado ali e não em /var/lib/postgresql/data como nas versões anteriores.A primeira inicialização executa as migrações do banco de dados e baixa o catálogo de exercícios; em nosso VPS de teste, o Ryot respondeu em poucos segundos. Para verificar se ele 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 retorna a configuração que o servidor carregou, em JSON, com os segredos ocultados: um jeito prático de conferir uma variável.
O contêiner serve o Ryot em HTTP, na porta 8000. O HTTPS fica a cargo de um proxy reverso colocado na frente, que deve repassar o cabeçalho Host público e X-Forwarded-Proto. Testamos o Caddy, instalado a partir do repositório oficial dele para Debian e Ubuntu: ele obtém sozinho o certificado Let’s Encrypt, renova-o, e repassa esses cabeçalhos por padrão.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.O Ryot não tem conta padrão, e os cadastros ficam abertos em uma instância nova. A primeira conta criada recebe o papel Admin; as seguintes são usuários normais. Crie a sua logo após a primeira inicialização:
Para uma instância privada, feche os cadastros: acrescente USERS_ALLOW_REGISTRATION=false ao ambiente do serviço ryot, depois execute docker compose up -d. Em nosso VPS de teste, o link “Create a new account?” desapareceu, e uma tentativa de cadastro pelo endereço de cadastro foi recusada pelo servidor com “Registration is disabled”.
Testamos com os cadastros fechados: a conta convidada foi criada como usuário normal, a senha dela foi definida pelo link, e ela chegou ao próprio painel.
Para entrar com as contas de 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 em seu provedor.
O Ryot busca os detalhes e as capas de cada tipo de mídia em um provedor. Alguns funcionam sem chave, outros precisam de uma chave sua, já que as chaves compartilhadas foram removidas na v9:
| Mídia | Provedor | O que definir |
|---|---|---|
| Livros | Open Library | Nada: funciona na hora. Google Books e Hardcover são opcionais, com a chave de API deles |
| Filmes e séries | TMDB, ou TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, o API Read Access Token de uma conta gratuita do TMDB, ou MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videogames | IGDB, pela Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID e VIDEO_GAMES_TWITCH_CLIENT_SECRET, de um aplicativo no console de desenvolvedores da Twitch |
| Música | Spotify, opcional | MUSIC_SPOTIFY_CLIENT_ID e MUSIC_SPOTIFY_CLIENT_SECRET |
| Importação de animes | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, necessário apenas para importar do MyAnimeList |
Essas chaves são segredos: coloque-as no arquivo .env, acrescente uma linha como - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} ao ambiente do serviço ryot, depois execute docker compose up -d. A página de configuração da documentação lista todas as outras variáveis.
Tudo fica em dois lugares: o banco de dados PostgreSQL, no volume postgres_storage, e seu arquivo .env. Guarde este último em lugar seguro: SERVER_ADMIN_ACCESS_TOKEN é necessário para ler os segredos de dois fatores armazenados no banco de dados. A imagem do PostgreSQL inclui o pg_dump. O dump contém todas as contas e o histórico delas, então crie-o legível apenas pelo root, com umask 077 entre parênteses: o resto de sua sessão mantém a máscara de sempre. Um arquivo que já existe mantém as permissões dele quando é sobrescrito, então a linha find fecha primeiro os dumps e as cópias que já estão na pasta, antes de qualquer gravação, e interrompe o backup se nã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
)
Agende essa cópia e envie-a para fora do servidor. Guardados no disco, os dumps também entram nos backups noturnos do servidor.
Na mesma instalação ou em uma nova, com o mesmo .env, pare o aplicativo, substitua o banco de dados por um vazio, carregue nele o dump e depois inicie o aplicativo de novo:
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 a restauração no primeiro erro, em vez de seguir adiante e relatar os erros no fim, e os && interrompem a sequência ali: o Ryot continua parado. O que foi carregado antes do erro fica no banco de dados, então recomece a partir do dropdb depois de corrigir a causa.Testamos o ciclo completo em nosso VPS com exatamente esses comandos: dump, banco de dados apagado e criado de novo vazio, restauração. As duas contas, as coleções delas e os 876 exercícios voltaram, e o administrador entrou de novo na hora.
O Ryot também exporta seus próprios dados em JSON, pela página de configurações “Imports and Exports”, e consegue importá-los de volta. Essa exportação precisa de um armazenamento de arquivos compatível com S3; o dump do banco de dados acima funciona sem ele.
O Ryot lança versões com frequência, mais ou menos toda semana. Leia as notas da versão, faça um backup, troque a tag da imagem no compose.yaml, depois baixe a nova imagem e recrie o contêiner. As migrações do banco de dados rodam sozinhas na inicialização:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop segue o branch principal: a documentação avisa que ela costuma ter bugs graves e pode perder dados. Fique nas versões publicadas.O Ryot coleta dados de uso anônimos, visualizações de página e alguns eventos, em uma instância Umami auto-hospedada pelo desenvolvedor. Para desativá-la, acrescente DISABLE_TELEMETRY=true ao ambiente do serviço ryot, depois execute docker compose up -d.
A auto-hospedagem exige cuidar do servidor além da aplicação. Em um VPS gerenciado, nossas equipes assumem o servidor e acompanham sua instância de forma proativa; o Ryot continua sendo seu software, com seu histórico e suas configurações.
| Assunto | Nossas equipes | Você |
|---|---|---|
| O servidor | Atualizações do sistema e de segurança, com intervenções no servidor incluídas | O momento que convém a você |
| A supervisão | Servidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar sua ligação | Seu histórico, suas coleções e suas integrações no Ryot |
| Ryot | Acompanhamento proativo: erros, lentidões, banco de dados e espaço em disco identificados, correção recomendada | A instalação, as atualizações, as chaves de API e as configurações dele, que você aplica, por conta própria ou com seu assistente de IA |
| Os usuários | O servidor que os sustenta, monitorado e com backup | As contas, os cadastros e o login único |
| Os backups | Toda noite, criptografados e guardados fora da máquina; restauração incluída | Os dumps do banco de dados e as exportações JSON próprios do Ryot e o pedido de restauração, quando você precisar |
| A migração | Seu servidor atual migrado, grátis | O momento da virada |
Se você preferir que nossas equipes intervenham na própria aplicação, esse serviço é cobrado por hora ou por valor fechado, com o orçamento informado antes da intervenção.
Com um VPS gerenciado Simafri, nossas equipes mantêm atualizado o servidor de sua instância Ryot, monitoram-no dia e noite e intervêm sem esperar sua ligação; elas também acompanham sua instância de forma proativa e recomendam as correções úteis, que você aplica por conta própria ou com seu assistente de IA. Os backups são criptografados todas as noites e guardados fora da máquina, a restauração está incluída, e a migração de seu servidor atual é grátis.
Sim. O Ryot está sob a licença GPL-3.0: você pode rodá-lo para você, sua família ou sua equipe sem licença a comprar. O Ryot Pro é uma chave paga opcional que acrescenta recursos à mesma imagem. Resta o custo do servidor em que ele roda.
Use a imagem ignisda/ryot e o PostgreSQL 18 em um compose.yaml. Coloque a senha do banco de dados e SERVER_ADMIN_ACCESS_TOKEN em um arquivo .env, defina FRONTEND_URL com seu endereço https, publique a porta 8000 em 127.0.0.1, execute docker compose up -d e coloque na frente um proxy reverso em HTTPS.
Não há nenhum. Clique em “Create a new account?” na página de login: a primeira conta criada se torna a do administrador. Depois, defina USERS_ALLOW_REGISTRATION=false para fechar os cadastros; o administrador convida os outros usuários em Settings, Users, com um link de uso único.
Desde a v9, filmes e séries precisam de seu próprio token do TMDB: crie uma conta gratuita no TMDB, solicite uma chave de API e coloque o API Read Access Token dela em MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Os videogames precisam de um aplicativo da Twitch, enquanto os livros funcionam sem nenhuma chave.
Pouca. Em nosso VPS de teste, uma instalação nova usava 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 do banco de dados PostgreSQL com docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot sob umask 077, para que só o root possa lê-lo, e guarde uma cópia de seu arquivo .env. Para restaurar, pare o aplicativo, recrie o banco de dados vazio com dropdb e createdb, depois carregue o dump com pg_restore --exit-on-error --no-owner.
Leia as notas da versão e faça um backup, troque a tag da imagem no compose.yaml, depois execute docker compose pull e docker compose up -d. As migrações do banco de dados rodam sozinhas na inicialização. Entre versões principais, siga a página de migração.
Um VPS gerenciado cobre o servidor: sistema, segurança, supervisão e backups. Nossas equipes também acompanham sua instância de forma proativa e recomendam as correções úteis, que você aplica. Uma intervenção na aplicação é cobrada por hora ou por valor fechado.
Simafri
Vamos falar de seu site
Conte para a gente sobre seu projeto em poucas palavras: responderemos rapidamente.
Obrigado! O seu pedido foi enviado. Responderemos em breve.
Prefere o e-mail? Escreva para a gente em support@simafri.com.