Alojar Ryot num VPS gerido: o registo dos seus conteúdos e dos seus treinos

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.

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

Todos os guias

O essencial

  1. A licença GPL-3.0 permite-lhe executar o Ryot para si, para a sua família ou para o seu clube sem licença para comprar; o Ryot Pro, uma chave paga, acrescenta funcionalidades sobre a mesma imagem.
  2. Instale-o com o 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 inverso em HTTPS.
  3. Coloque a palavra-passe da base de dados e SERVER_ADMIN_ACCESS_TOKEN num ficheiro .env, e defina FRONTEND_URL com o seu endereço público.
  4. A primeira conta que criar torna-se a do administrador; depois, defina USERS_ALLOW_REGISTRATION=false para fechar os registos numa instância privada.
  5. Os livros funcionam de imediato; os filmes e as séries precisam de um token do TMDB, os videojogos de uma aplicação Twitch. Faça cópia com pg_dump e atualize alterando a etiqueta da imagem.

O que faz o Ryot

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

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.

Os recursos a prever

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.

A instalação com o 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. 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:

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 para um ficheiro .env ao lado, que o Docker Compose lê sozinho. Crie-o legível apenas pelo root e depois arranque 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

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:

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 devolve a configuração carregada pelo servidor, em JSON, com os segredos ocultados: uma forma prática de verificar uma variável.

HTTPS: o proxy inverso

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.

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

A primeira conta, os registos e os convites

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:

  1. Abra o seu endereço: o Ryot mostra a sua página de início de sessão.
  2. Clique em «Create a new account?» e depois introduza um nome de utilizador e duas vezes uma palavra-passe.
  3. Registe-se e depois inicie sessão com as suas novas credenciais: chega ao painel, com uma visita guiada de boas-vindas.
  4. Em «Settings», «Users», a sua conta aparece com a função Admin.

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

Convidar os outros utilizadores

  1. Em «Settings», «Users», clique no botão + ao lado do título.
  2. Introduza o nome de utilizador da pessoa: o Ryot cria a conta e mostra uma ligação de utilização única.
  3. Envie a ligação: a pessoa abre-a, escolhe uma palavra-passe e depois inicia sessão.

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.

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

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údoFornecedorO que definir
LivrosOpen LibraryNada: funciona de imediato. O Google Books e o Hardcover são opcionais, com a respetiva chave de API
Filmes e sériesTMDB, ou TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, o API Read Access Token de uma conta TMDB gratuita, ou MOVIES_AND_SHOWS_TVDB_API_KEY
VideojogosIGDB, através da TwitchVIDEO_GAMES_TWITCH_CLIENT_ID e VIDEO_GAMES_TWITCH_CLIENT_SECRET, de uma aplicação na consola de programadores da Twitch
MúsicaSpotify, opcionalMUSIC_SPOTIFY_CLIENT_ID e MUSIC_SPOTIFY_CLIENT_SECRET
Importação de animeMyAnimeListANIME_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.

As cópias de segurança

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:

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
)

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.

O restauro

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:

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

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.

As atualizações

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:

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

A telemetria

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.

Quem faz o quê num VPS gerido

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.

AssuntoAs nossas equipasVocê
O servidorAtualizações do sistema e de segurança, intervenções no servidor incluídasO momento que lhe convém
A supervisãoServidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar pela sua chamadaO seu histórico, as suas coleções e as suas integrações no Ryot
RyotAcompanhamento proativo: erros, lentidão, base de dados e espaço em disco identificados, correção recomendadaA 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 utilizadoresO servidor que os suporta, vigiado e com cópias de segurançaAs contas, os registos e o início de sessão único
As cópias de segurançaTodas as noites, cifradas e guardadas fora da máquina; restauro incluídoOs dumps da base de dados e as exportações JSON próprios do Ryot e o pedido de restauro, quando precisar
A migraçãoO seu servidor atual migrado, oferecidoO 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.

O Ryot, num servidor mantido por si

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.

Descobrir os VPS geridos

Perguntas frequentes

O Ryot é gratuito?

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.

Como instalar o Ryot com o Docker Compose?

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.

Quais são os acessos por omissão do Ryot?

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.

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

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.

De quanta memória precisa o Ryot?

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.

Como fazer cópia de segurança do Ryot?

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.

Como atualizar o Ryot?

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

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.

Guias relacionados

Alojar PostgreSQL num VPS: dimensionar a memória e o discoUma base PostgreSQL rápida é uma base cujos dados consultados com frequência cabem em memória. Todo o dimensionamento parte daí: o volume da base, a parte que trabalha realmente, o número de ligações, e depois o disco e a sua margem. Este guia apresenta o método, as definições de partida para 4, 8 e 16 GB de memória, e as consultas que medem uma base existente.Backups de um VPS: o que verificar antes de contratarUma oferta de VPS anuncia quase sempre «cópias de segurança incluídas». Por trás destas palavras pode haver uma cópia todas as noites, guardada fora da máquina e restaurada por especialistas, ou um instantâneo colocado no mesmo disco que o servidor. Este guia dá as perguntas que fazem a diferença, o que cada resposta quer dizer, e a forma de verificar que uma cópia de segurança se restaura.Alojar Actual Budget num VPS gerido: os seus orçamentos no seu servidorAlojar Actual Budget num VPS gerido é guardar os seus orçamentos e a respetiva sincronização numa máquina sua, que as nossas equipas mantêm atualizada e supervisionam dia e noite. O Actual Budget é uma ferramenta de finanças pessoais que trabalha primeiro em local, publicada sob licença MIT. Este guia segue a sua documentação oficial: o papel do servidor, a instalação com o Docker Compose, o HTTPS, a palavra-passe do servidor, o OpenID, a cifragem de ponta a ponta, a sincronização bancária, as cópias de segurança e as atualizações.
Contacte-nos