Logs bekijken
Begin altijd met de logs. Daar staat meestal wat er mis is.
In de Docker-images schrijft het portaal zijn logs niet naar een bestand, maar naar de uitvoer van de container.
Het installatiescript stopt
Gaat er iets mis, dan stopt het script met een regel die begint met “Fout:”.
Zie je aan het eind “Het portaal antwoordt nog niet; bekijk de logs met: openminetopia-portal logs”? Dan is de installatie wel klaar, maar antwoordde het portaal nog niet. Bekijk de logs.
De database is niet bereikbaar
Het portaal wacht bij het starten op de database. Lukt dat niet, dan zie je “De database is niet bereikbaar:” met de foutmelding van de database erachter.
Kan
portal:install de database niet bijwerken, dan zie je “De database kon niet worden bijgewerkt. Controleer de databasegegevens in .env en draai dit commando opnieuw.”
Bij Docker zonder script zie je “Zet DB_PASSWORD in .env” of “Zet DB_ROOT_PASSWORD in .env” als een wachtwoord ontbreekt. Zie Docker.
Het portaal is nog niet ingericht
Zie je in de logs “Het portaal is nog niet ingericht. Draai: php artisan portal:install”? Dan draait alleen de webserver. Richt het portaal in:De verbinding met de plugin testen
Test of het portaal de plugin bereikt en of deapi-key klopt:
Je ziet eerst “Plugin testen op” met het adres van de plugin. Daarna een van deze meldingen. Hierin staan
203.0.113.10, mc.jouwserver.nl en 4567 voor jouw adres en poort.
Het adres van de plugin pas je aan met
openminetopia-portal instellen, portal:install of, bij Pterodactyl, de variabelen PLUGIN_HOST en PLUGIN_PORT.
Koppelen met /koppel lukt niet
Werkt/koppel niet, dan staat de oorzaak in de console van je Minecraft-server. Alle meldingen en oplossingen staan bij Koppelen met de plugin.
Draait je portaal zonder HTTPS? Dan werkt /koppel pas met een plugin-versie die http:// in portal.url ondersteunt. Dat kan met een build van de master-branch van de plugin, of met een release die nieuwer is dan 1.5.0. portal:install waarschuwt hiervoor met “Je portaal draait zonder HTTPS.”
HTTPS werkt niet
Met het installatiescript of Docker regelt Caddy het HTTPS-certificaat zelf. Controleer dit:- Je hebt een domeinnaam ingevuld, geen IP-adres. Met een IP-adres draait het portaal alleen op HTTP.
- De domeinnaam wijst al naar het IP-adres van je server.
- Poort 80 en 443 staan open.
- Caddy vraagt het certificaat aan als het portaal start. Dat kan een minuut duren.
caddy-data. Ze blijven bewaard als je het portaal herstart of bijwerkt.
Pterodactyl geeft het portaal alleen HTTP. Voor HTTPS zet je er zelf een reverse proxy of Cloudflare voor. Zie Pterodactyl.
De beheerderslink werkt niet meer
Een link om beheerder te worden werkt één keer en is standaard 24 uur geldig. Een nieuwe link maakt de vorige ongeldig. Is de link verlopen of al gebruikt, dan zie je “Deze link werkt niet meer”. Maak dan een nieuwe:
Met
--hours= kies je hoe lang de link geldig is. Open de link meteen en log in of maak een account aan. Daarna zie je “Je bent nu beheerder van dit portaal.”
Beheerder maken zonder link
Beheerder maken zonder link
Heeft de persoon al een account op het portaal? Dan maak je die ook zonder link beheerder:In plaats van het e-mailadres mag ook het id van het account. Zonder
--role-id zoekt het commando rollen met “admin” in de naam en laat je er een kiezen. Vindt het die niet, dan kiest het de rol met id 1. In een nieuw portaal is dat de rol Beheerder. Met --force slaat het de bevestiging over.Met het installatiescript gebruik je openminetopia-portal artisan user:set-admin. Bij Docker zonder script zet je er docker compose exec portal voor.