Begin bij de foutmelding van het installatiescript of de controles in de console. Houd privéclaimlinks, API-sleutels, wachtwoorden en herstelmateriaal buiten supportmeldingen.
Het script of alfakanaal is niet beschikbaar
Controleer of de server de releasehost en containerregistry kan bereiken. Open de gegevens van de huidige alfarelease en controleer of de bijbehorende release en vereiste bestanden bij AppSweet-releases staan. Ontbreekt een vereist bestand of mislukt de handtekeningcontrole, behoud dan de installatiestatus en probeer het later opnieuw. Meld een blijvende fout met de releasetag en foutmelding. Gebruik geen bestanden uit een andere release en schakel verificatie niet uit.
De console verschijnt niet
Open bij Dokploy de consolehostnaam die je in Environment hebt ingevuld. De Compose-installer toont geen privéclaimlink: vul je bewaarde installatiesleutel in op het claimscherm. Controleer Deployments, de containerlogs, DNS, poorten 80 en 443 en de proxy- en netwerkvoorwaarden in Installeren op Dokploy. De tweede deployment start automatisch. Behoud de gegenereerde definitie en volumes wanneer je opnieuw probeert.
Het installatiescript voor een losse server toont de privéclaimlink pas na een voltooide deployment en geverifieerde HTTPS. Herstel de gemelde fout en voer hetzelfde commando opnieuw uit, met behoud van installatiemap en volumes. Ontbrekende SMTP-instellingen blokkeren de eerste consoletoegang in geen van beide processen.
Dokploy weigert de geselecteerde service
Gebruik een aparte Compose-service met de oorspronkelijke App Name
en plak de gepubliceerde installer ongewijzigd. Het voorvoegsel appsweet- is niet verplicht. AppSweet weigert vreemde definities
en resources. Maak geen service van een bestaande toepassing leeg om dit te omzeilen.
Controleer of APPSWEET_DOKPLOY_SERVICE_URL het https://-adres is van de pagina
van deze Compose-service in Dokploy, en of APPSWEET_DOKPLOY_API_KEY een geldige
sleutel is van een Dokploy-gebruiker die deze service mag beheren. Laat Domains
leeg en voeg geen File Mounts toe.
Verbeter onjuiste invoer vóór de toegangscontrole in Dokploy en druk opnieuw op Deploy voor dezelfde service. Herstel na die controle de oorspronkelijke waarden als ze zijn veranderd. Volg bij een onderbroken overdracht de herstartinstructies; plak de installer nooit over de gegenereerde console.
De claimtoegang is verlopen of de installatie is al geclaimd
Meld je bij een geclaimde installatie aan met het consolebeheerdersaccount. De installatiesleutel kan deze niet nogmaals claimen. Een verloren installatiesleutel of verlopen ongeclaimde Compose-installatie vereist herstel door de operator; behoud de opgeslagen status.
Voeg alleen bij het installatiescript voor een losse server --renew-claim toe
aan het oorspronkelijke commando en voer het als root uit. Behoud installatiemap
en koppeling. Deze optie stelt een bestaande beheerder niet opnieuw in.
Opgeslagen instellingen zijn niet actief
Opslaan maakt een concept. Open de controlepagina van de console, voer de controles uit en pas de revisie toe. Mislukt een controle of toepassing, dan blijft de vorige toegepaste configuratie behouden. Herstel DNS-, SMTP- of opslaginstellingen in de console en probeer het daar opnieuw. Bewerk geen gegenereerde Compose-bestanden of omgevingsvariabelen om de controles te omzeilen.
Updates
Configureer back-ups in de console en zorg voor een recente geverifieerde back-up van de draaiende release op deze installatie. Een oude opname opnieuw verifiëren maakt die niet vers. Met uitgestelde of verouderde back-ups blijven updateacties onbeschikbaar. De executor controleert ook releasecompatibiliteit en authenticiteit van de back-up.
Meegeleverde bestandsopslag kan een onafhankelijk extern back-updoel gebruiken; je hoeft bestandsopslag niet te vervangen om back-ups in te schakelen. Automatische alfa-aflevering vereist daarnaast expliciete aanmelding van deze installatie.
Een server die is geïnstalleerd voordat AppSweet een eigen aanmelding had, kun je niet bijwerken. Installeer AppSweet opnieuw en nodig je mensen opnieuw uit; oudere back-ups kun je niet in de nieuwe installatie terugzetten.
Herstellen na verlies van de server
Bewaar toegang tot de back-upbucket, de privésleutel voor back-ups en het verificatiemateriaal van de installatie buiten de verloren server. Herstel vereist ook een volledige geverifieerde back-up en ondersteunde opslagconfiguratie; een draaiende container of opgeslagen back-upschema bewijst geen herstelbaarheid.
Herstel naar een schone bestemming vereist momenteel externe S3 met objectversies op de uploadbucket. De meegeleverde bestandsopslag biedt die versiegeschiedenis niet. Gebruik de herstelhandleiding voor de exacte geïnstalleerde release en oefen herstel voordat je erop vertrouwt.
De image wil niet pullen
Controleer of Docker draait, de schijf ruimte heeft en de server de registry uit de release kan bereiken. Images zijn openbaar; een registry-login is niet nodig. Controleer proxy-, firewall- en DNS-fouten voordat je opnieuw probeert. Volg bij Dokploy de bovenstaande herstartinstructies; voer bij het losse installatiescript hetzelfde commando opnieuw uit. Behoud installatiestatus en volumes.