Ryotin hostaus Managed VPS:llä tarkoittaa, että katsomienne, lukemienne, pelaamienne ja nostamienne asioiden historia pysyy palvelimella, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. Ryot on GPL-3.0-lisenssillä julkaistu vapaa ja avoimen lähdekoodin seurantasovellus elokuville, sarjoille, kirjoille, peleille, podcasteille, musiikille ja treeneille. Tämä opas seuraa sen virallista Docker-imagea versiossa v10.5.8, ja ajoimme jokaisen komennon Simafrin VPS:llä ennen sen kirjoittamista: asennus Docker Composella ja PostgreSQL:llä, HTTPS, ensimmäinen tili, kunkin mediatyypin API-avaimet, varmuuskopiot ja päivitykset.
Kirjoittaja: Simon Vasconcelos Lee
Julkaistu 19. marraskuuta 2026Lukuaika: 11 minuuttia
ignisda/ryot ja PostgreSQL 18, ja portti 8000 julkaistuna osoitteessa 127.0.0.1 HTTPS:llä toimivan käänteisen välityspalvelimen takana.SERVER_ADMIN_ACCESS_TOKEN .env-tiedostoon ja asettakaa julkinen osoitteenne muuttujaan FRONTEND_URL.USERS_ALLOW_REGISTRATION=false, niin rekisteröityminen sulkeutuu yksityisessä instanssissa.pg_dump ja päivittäkää sitten vaihtamalla imagen tagi.Ryot, nimestä ”Roll Your Own Tracker” ja lausuttuna ”riot”, kokoaa yhteen paikkaan sen, mitä olette katsoneet, lukeneet, pelanneet ja treenanneet, tilastoineen, tulevien julkaisujen kalentereineen ja omine kokoelmineen. Sen kehittäjä IgnisDa kirjoittaa sitä Rustilla, ja sen verkkokäyttöliittymän voi asentaa puhelimeen sovelluksena.
Ryot julkaistaan GNU General Public License -lisenssin versiolla 3 (GPL-3.0). Voitte käyttää sitä maksutta itsellenne, perheellenne, seurallenne tai yrityksellenne, kopioida sitä ja muokata sitä. Jos levitätte muokattua versiota, levitätte sen lähdekoodin saman lisenssin alaisena. Ohjelmisto toimitetaan ilman takuuta.
Ryot Pro on kehittäjän myymä maksullinen avain, joka avaa lisäominaisuuksia, kuten profiilin jakamisen ja henkilökohtaiset suositukset. Se asetetaan saman imagen muuttujaan SERVER_PRO_KEY, ja palvelin palaa yhteisöversioon, jos avain vanhenee. Mikään tässä oppaassa ei tarvitse sitä.
Dokumentaatio ei aseta vähimmäiskokoa, ja Ryot on kevyt. Tässä on, mitä mittasimme testi-VPS:llämme juuri asennettuna:
Palvelimen koko riippuu siis käyttäjien määrästä ja muista sovelluksista, joita ajatte Ryotin rinnalla. Managed VPS -palvelimella kertokaa meille käytöstänne, niin suosittelemme sopivaa kokoa.
Ryot toimitetaan yhtenä imagena, ignisda/ryot, joka julkaistaan myös nimellä ghcr.io/ignisda/ryot ja joka tarjoaa sekä käyttöliittymän että rajapinnan portissa 8000. Se tarvitsee PostgreSQL 15:n tai uudemman, joka toimii sen rinnalla omassa kontissaan. Luokaa palvelimelle, jolla on Docker Engine ja sen Compose-laajennus Dockerin Ubuntu-repositoriosta asennettuina, kansio kuten /opt/ryot ja tallentakaa siihen tämä asennussivun tiedostoon perustuva 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:
Kaksi salaisuutta tulevat sen viereen .env-tiedostoon, jonka Docker Compose lukee itsestään. Luokaa se vain rootin luettavaksi ja käynnistäkää sitten kokonaisuus:
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: viitetiedosto julkaisee sen ilman osoitetta, jolloin Docker avaa sen palvelimen kaikkiin osoitteisiin. Paikallisesti julkaistuna siihen pääsee vain käänteisen välityspalvelimen kautta.postgres. Tässä oma käyttäjä ryot saa satunnaisen salasanan heksadesimaalimuodossa, jotta sitä ei tarvitse koodata muuttujassa DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN on pakollinen: se valtuuttaa ylläpitotoimet rajapinnan kautta, ja se salaa käyttäjienne kaksivaiheisen tunnistautumisen salaisuudet. Pitäkää se salassa ja pitäkää se muuttumattomana: toisella tunnuksella näitä salaisuuksia ei voi enää lukea.FRONTEND_URL on julkinen osoitteenne muodossa https://. Ryot käyttää sitä luomiensa linkkien pohjana, ja OpenID Connect tarvitsee sitä.TZ on ajastettujen tehtävien aikavyöhyke, oletuksena GMT: asettakaa omanne IANA-luettelosta.v10 asetuksella pull_policy: always, joka seuraa jokaista alaversiota jokaisella käynnistyksellä. Täydellisellä versionumerolla, tässä v10.5.8, päätätte itse, milloin kukin päivitys tehdään.postgres_storage sisältää kaikki tietonne. PostgreSQL 18 säilyttää ne polussa /var/lib/postgresql, minkä vuoksi taltio liitetään sinne eikä polkuun /var/lib/postgresql/data kuten vanhemmissa versioissa.Ensimmäinen käynnistys ajaa tietokannan migraatiot ja lataa liikeluettelon; testi-VPS:llämme Ryot vastasi muutamassa sekunnissa. Tarkistaaksenne, että se vastaa:
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
Ensimmäinen komento vastaa 200. Toinen palauttaa palvelimen lataaman määrityksen JSON-muodossa salaisuudet peitettyinä: kätevä tapa tarkistaa muuttuja.
Kontti tarjoaa Ryotin HTTP:llä portissa 8000. HTTPS:stä huolehtii sen edessä oleva käänteinen välityspalvelin, jonka on välitettävä julkinen Host-otsake ja X-Forwarded-Proto. Testasimme Caddyn, joka asennettiin sen virallisesta Debian- ja Ubuntu-repositoriosta: se hankkii Let’s Encryptin varmenteen itse, uusii sen ja välittää nämä otsakkeet oletuksena.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryotissa ei ole oletustiliä, ja rekisteröityminen on uudessa instanssissa avoinna. Ensimmäinen tili, joka luodaan, saa roolin Admin; seuraavat ovat tavallisia käyttäjiä. Luokaa omanne heti ensimmäisen käynnistyksen jälkeen:
Yksityisessä instanssissa sulkekaa rekisteröityminen: lisätkää USERS_ALLOW_REGISTRATION=false palvelun ryot ympäristöön ja ajakaa sitten docker compose up -d. Testi-VPS:llämme linkki ”Create a new account?” katosi, ja palvelin hylkäsi rekisteröitymisosoitteesta yritetyn rekisteröitymisen viestillä ”Registration is disabled”.
Testasimme tämän rekisteröitymisen ollessa suljettuna: kutsuttu tili luotiin tavallisena käyttäjänä, sen salasana asetettiin linkin kautta, ja se pääsi omalle kojelaudalleen.
Jos haluatte kirjautua yrityksenne tileillä, Ryot tukee OpenID Connectia: asettakaa SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET ja SERVER_OIDC_ISSUER_URL ja ilmoittakaa palveluntarjoajallenne uudelleenohjausosoitteeksi https://ryot.example.com/api/auth.
Ryot hakee kunkin mediatyypin tiedot ja kansikuvat palveluntarjoajalta. Osa toimii ilman avainta, osa tarvitsee omanne, koska jaetut avaimet poistettiin versiossa v9:
| Media | Palveluntarjoaja | Mitä asetetaan |
|---|---|---|
| Kirjat | Open Library | Ei mitään: toimii heti. Google Books ja Hardcover ovat valinnaisia, API-avaimineen |
| Elokuvat ja sarjat | TMDB tai TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, maksuttoman TMDB-tilin API Read Access Token, tai MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videopelit | IGDB, Twitchin kautta | VIDEO_GAMES_TWITCH_CLIENT_ID ja VIDEO_GAMES_TWITCH_CLIENT_SECRET Twitchin kehittäjäkonsolin sovelluksesta |
| Musiikki | Spotify, valinnainen | MUSIC_SPOTIFY_CLIENT_ID ja MUSIC_SPOTIFY_CLIENT_SECRET |
| Animen tuonti | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, tarpeen vain tuotaessa MyAnimeLististä |
Nämä avaimet ovat salaisuuksia: tallentakaa ne .env-tiedostoon, lisätkää palvelun ryot ympäristöön rivi kuten - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} ja ajakaa sitten docker compose up -d. Dokumentaation määrityssivu luettelee kaikki muut muuttujat.
Kaikki on kahdessa paikassa: PostgreSQL-tietokannassa taltiossa postgres_storage ja .env-tiedostossanne. Säilyttäkää jälkimmäinen turvassa: SERVER_ADMIN_ACCESS_TOKEN tarvitaan tietokantaan tallennettujen kaksivaiheisen tunnistautumisen salaisuuksien lukemiseen. PostgreSQL-image sisältää työkalun pg_dump. Vedos sisältää kaikki tilit ja niiden historian, joten luokaa se vain rootin luettavaksi suluissa olevalla umask 077 -asetuksella: muu istuntonne säilyttää tavallisen maskinsa. Jo olemassa oleva tiedosto säilyttää oikeutensa, kun se korvataan, joten find-rivi sulkee ensin kansiossa jo olevat vedokset ja kopiot, ennen kuin mitään kirjoitetaan, ja keskeyttää varmuuskopioinnin, jos se ei onnistu:
(
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
)
Ajastakaa tämä kopio ja lähettäkää se palvelimen ulkopuolelle. Levylle tallennettuina vedokset sisältyvät myös palvelimen öisiin varmuuskopioihin.
Samassa tai uudessa asennuksessa, samalla .env-tiedostolla, pysäyttäkää sovellus, korvatkaa tietokanta tyhjällä, ladatkaa vedos siihen ja käynnistäkää sovellus sitten uudelleen:
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 pysäyttää palautuksen ensimmäiseen virheeseen sen sijaan, että jatkaisi ja raportoisi virheet lopuksi, ja && pysäyttävät ketjun siihen: Ryot pysyy pysäytettynä. Ennen virhettä ladattu jää tietokantaan, joten aloittakaa uudelleen komennosta dropdb, kun syy on korjattu.Testasimme koko kierroksen VPS:llämme juuri näillä komennoilla: vedos, tietokannan poistaminen ja luominen uudelleen tyhjänä, palautus. Molemmat tilit, niiden kokoelmat ja 876 liikettä palasivat, ja ylläpitäjä kirjautui heti uudelleen sisään.
Ryot vie myös omat tietonne JSON-muodossa asetussivulta ”Imports and Exports”, ja se voi tuoda ne takaisin. Tämä vienti tarvitsee S3-yhteensopivan tiedostotallennustilan; yllä kuvattu tietokantavedos toimii ilman sitä.
Ryotista julkaistaan uusia versioita usein, suunnilleen viikoittain. Lukekaa julkaisutiedotteet, ottakaa varmuuskopio, vaihtakaa imagen tagi tiedostossa compose.yaml, hakekaa sitten uusi image ja luokaa kontti uudelleen. Tietokannan migraatiot ajetaan itsestään käynnistyksen yhteydessä:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop seuraa päähaaraa: dokumentaatio varoittaa, että siinä on usein vakavia bugeja ja että se voi hävittää tietoja. Pysykää julkaisuversioissa.Ryot kerää anonyymejä käyttötietoja, sivujen katseluja ja muutamia tapahtumia, kehittäjänsä itse hostaamaan Umami-instanssiin. Poistaaksenne sen käytöstä lisätkää DISABLE_TELEMETRY=true palvelun ryot ympäristöön ja ajakaa sitten docker compose up -d.
Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Ryot pysyy teidän ohjelmananne historianne ja asetustenne kanssa.
| Aihe | Tiimimme | Te |
|---|---|---|
| Palvelin | Järjestelmä- ja tietoturvapäivitykset, toimenpiteet palvelimella mukaan lukien | Teille sopiva ajankohta |
| Valvonta | Palvelinta seurataan ympäri vuorokauden joka päivä, ja puututaan asiaan odottamatta yhteydenottoanne | Historianne, kokoelmanne ja integraationne Ryotissa |
| Ryot | Proaktiivinen seuranta: virheet, hitaus, tietokanta ja levytila havaitaan, ja korjausta suositellaan | Sen asennus, päivitykset, API-avaimet ja asetukset, jotka toteutatte itse tai tekoälyavustajanne kanssa |
| Käyttäjät | Niitä kantava palvelin, valvottuna ja varmuuskopioituna | Tilit, rekisteröityminen ja kertakirjautuminen |
| Varmuuskopiot | Joka yö, salattuina ja koneen ulkopuolella säilytettyinä; palautus sisältyy | Ryotin omat tietokantavedokset ja JSON-viennit sekä palautuspyyntö, kun tarvitsette sitä |
| Siirto | Nykyinen palvelimenne siirretään, veloituksetta | Käyttöönoton ajankohta |
Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.
Simafrin Managed VPS -palvelussa tiimimme pitävät Ryot-instanssinne palvelimen ajan tasalla, valvovat sitä yötä päivää ja toimivat odottamatta yhteydenottoanne; ne seuraavat myös instanssianne proaktiivisesti ja suosittelevat teille hyödyllisiä korjauksia, jotka toteutatte itse tai tekoälyavustajanne kanssa. Varmuuskopiot salataan joka yö ja säilytetään koneen ulkopuolella, niiden palautus sisältyy, ja nykyisen palvelimenne siirto tehdään veloituksetta.
Kyllä. Ryot on GPL-3.0-lisenssin alainen: voitte ajaa sitä itsellenne, perheellenne tai tiimillenne ostamatta lisenssiä. Ryot Pro on valinnainen maksullinen avain, joka lisää ominaisuuksia samaan imageen. Kuluksi jää sitä ajavan palvelimen hinta.
Käyttäkää imagea ignisda/ryot ja PostgreSQL 18:aa tiedostossa compose.yaml. Tallentakaa tietokannan salasana ja SERVER_ADMIN_ACCESS_TOKEN .env-tiedostoon, asettakaa FRONTEND_URL https-osoitteeseenne, julkaiskaa portti 8000 osoitteessa 127.0.0.1, ajakaa docker compose up -d ja sijoittakaa eteen HTTPS:llä toimiva käänteinen välityspalvelin.
Niitä ei ole. Napsauttakaa kirjautumissivulla ”Create a new account?”: ensimmäisestä luodusta tilistä tulee ylläpitäjä. Asettakaa sitten USERS_ALLOW_REGISTRATION=false, niin rekisteröityminen sulkeutuu; ylläpitäjä kutsuu muut käyttäjät kohdasta Settings, Users kertakäyttöisellä linkillä.
Versiosta v9 alkaen elokuvat ja sarjat tarvitsevat oman TMDB-tunnuksenne: luokaa maksuton TMDB-tili, pyytäkää API-avain ja asettakaa sen API Read Access Token muuttujaan MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videopelit tarvitsevat Twitch-sovelluksen, kun taas kirjat toimivat ilman avainta.
Vähän. Testi-VPS:llämme juuri tehty asennus käytti noin 240-300 Mt Ryotille ja 70 Mt PostgreSQL:lle, ja kaksi imagea vievät noin 810 Mt levytilaa.
Ottakaa PostgreSQL-tietokannasta vedos komennolla docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot asetuksella umask 077, jotta vain root voi lukea sen, ja säilyttäkää kopio .env-tiedostostanne. Palauttaaksenne pysäyttäkää sovellus, luokaa tietokanta uudelleen tyhjänä komennoilla dropdb ja createdb ja ladatkaa sitten vedos komennolla pg_restore --exit-on-error --no-owner.
Lukekaa julkaisutiedotteet ja ottakaa varmuuskopio, vaihtakaa imagen tagi tiedostossa compose.yaml ja ajakaa sitten docker compose pull ja docker compose up -d. Tietokannan migraatiot ajetaan itsestään käynnistyksen yhteydessä. Pääversioiden välillä seuratkaa siirtymissivua.
Managed VPS kattaa palvelimen: järjestelmän, tietoturvan, valvonnan ja varmuuskopiot. Tiimimme seuraavat myös instanssianne proaktiivisesti ja suosittelevat hyödyllisiä korjauksia, jotka toteutatte itse. Toimenpide sovelluksessa laskutetaan tuntiveloituksella tai kiinteällä hinnalla.
Simafri
Jutellaan hankkeestasi
Kerro meille muutamalla sanalla, mitä tarvitset: vastaamme sinulle nopeasti.
Kiitos! Pyyntösi on lähetetty. Vastaamme sinulle pian.
Suositko sähköpostia? Kirjoita meille osoitteeseen support@simafri.com.