Hospedar Ryot em um VPS gerenciado: o registro de suas mídias e de seus treinos

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.

Simon Vasconcelos Lee Por Publicado em 19 de novembro de 2026Leitura: 11 minutos

Todos os guias

O essencial

  1. A licença GPL-3.0 permite rodar o Ryot para você, sua família ou seu clube sem licença a comprar; o Ryot Pro, uma chave paga, acrescenta recursos sobre a mesma imagem.
  2. Instale-o com Docker Compose: a imagem ignisda/ryot e o PostgreSQL 18, com a porta 8000 publicada em 127.0.0.1 atrás de um proxy reverso em HTTPS.
  3. Coloque a senha do banco de dados e SERVER_ADMIN_ACCESS_TOKEN em um arquivo .env, e defina FRONTEND_URL com seu endereço público.
  4. A primeira conta que você criar se torna a do administrador; depois, defina USERS_ALLOW_REGISTRATION=false para fechar os cadastros em uma instância privada.
  5. Os livros funcionam na hora; os filmes e as séries precisam de um token do TMDB, os videogames de um aplicativo da Twitch. Faça backup com pg_dump e atualize trocando a tag da imagem.

O que o Ryot faz

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 que a licença GPL-3.0 permite

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.

Os recursos a prever

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.

A instalação com Docker Compose

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:

compose.yaml
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:

Terminal, em /opt/ryot
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

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:

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

HTTPS: o proxy reverso

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.

/etc/caddy/Caddyfile
ryot.example.com {
	reverse_proxy 127.0.0.1:8000
}
Terminal
sudo systemctl reload caddy

A primeira conta, os cadastros e os convites

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:

  1. Abra seu endereço: o Ryot mostra a página de login.
  2. Clique em “Create a new account?” e depois informe um nome de usuário e duas vezes uma senha.
  3. Cadastre-se e depois entre com suas novas credenciais: você chega ao painel, com um tour de boas-vindas.
  4. Em “Settings”, “Users”, sua conta aparece com o papel Admin.

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

Convidar os outros usuários

  1. Em “Settings”, “Users”, clique no botão + ao lado do título.
  2. Informe o nome de usuário da pessoa: o Ryot cria a conta e mostra um link de uso único.
  3. Envie o link: a pessoa o abre, escolhe uma senha e depois entra.

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.

Filmes, séries e jogos: as chaves de API

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ídiaProvedorO que definir
LivrosOpen LibraryNada: funciona na hora. Google Books e Hardcover são opcionais, com a chave de API deles
Filmes e sériesTMDB, ou TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, o API Read Access Token de uma conta gratuita do TMDB, ou MOVIES_AND_SHOWS_TVDB_API_KEY
VideogamesIGDB, pela TwitchVIDEO_GAMES_TWITCH_CLIENT_ID e VIDEO_GAMES_TWITCH_CLIENT_SECRET, de um aplicativo no console de desenvolvedores da Twitch
MúsicaSpotify, opcionalMUSIC_SPOTIFY_CLIENT_ID e MUSIC_SPOTIFY_CLIENT_SECRET
Importação de animesMyAnimeListANIME_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.

Os backups

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:

Terminal, em /opt/ryot
(
  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.

A restauração

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:

Terminal, em /opt/ryot
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

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.

As atualizações

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:

Terminal, em /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

A telemetria

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.

Quem faz o quê em um VPS gerenciado

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.

AssuntoNossas equipesVocê
O servidorAtualizações do sistema e de segurança, com intervenções no servidor incluídasO momento que convém a você
A supervisãoServidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar sua ligaçãoSeu histórico, suas coleções e suas integrações no Ryot
RyotAcompanhamento proativo: erros, lentidões, banco de dados e espaço em disco identificados, correção recomendadaA 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áriosO servidor que os sustenta, monitorado e com backupAs contas, os cadastros e o login único
Os backupsToda noite, criptografados e guardados fora da máquina; restauração incluídaOs 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çãoSeu servidor atual migrado, grátisO 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.

Ryot, em um servidor cuidado por nós

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.

Conhecer os VPS gerenciados

Perguntas frequentes

O Ryot é gratuito?

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.

Como instalar o Ryot com Docker Compose?

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.

Quais são os acessos padrão do Ryot?

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.

Por que o Ryot não encontra filmes nem séries?

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.

Quanta memória o Ryot exige?

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.

Como fazer backup do Ryot?

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.

Como atualizar o Ryot?

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 Ryot?

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.

Entre em contato