Installeer eerst de console en stel AppSweet daarna in via je browser. Je hoeft geen Compose-bestanden voor te bereiden, servicewachtwoorden te genereren of een omgevingsbestand in te vullen. Gebruik voor een bestaande Dokploy-host Installeren op Dokploy.
Deze handleiding installeert de huidige alfarelease. Alfareleases zijn voorlopige versies voor evaluatie in een niet-productieomgeving. Releases en images zijn openbaar te downloaden. Het script kiest de release uit het automatisch bijgewerkte alfakanaal.
Wat je nodig hebt
- Ubuntu 24.04 of Debian 12 op amd64 of arm64, met toegang tot een rootshell.
- 4 CPU's, minstens 8 GB geheugen en 40 GiB vrije ruimte op de blijvende schijf van Docker.
- Een vast publiek IPv4-adres en bereikbare, vrije poorten 80 en 443.
Het script installeert ontbrekende ondersteunde Docker- en Compose-pakketten en hergebruikt een geschikte runtime. Een ongeschikte runtime wordt geweigerd zonder die te vervangen. Het script wijzigt je firewallregels niet.
Stap 1 — voer het installatiescript uit
Voer dit uit vanuit een rootshell op de server:
curl -fsSL https://releases.appsweet.app/install.sh | sh -s -- --channel alpha
Je kunt het script eerst downloaden en bekijken. Het verifieert de geselecteerde
ondertekende release, bereidt privéinstallatiestatus voor en start de console via
HTTPS. De eerste consolehostnaam wordt afgeleid van de installatie-ID en het publieke IP.
Voor een eigen hostnaam voeg je --console-hostname console.example.com toe; de DNS
moet naar deze server wijzen. Heeft de server meerdere publieke adressen, geef dan
ook het bedoelde IPv4-adres mee met --public-ipv4.
Stap 2 — claim je console
Na verificatie van HTTPS en de installatie-identiteit toont het script een privéclaimlink. Open die en vul je bedrijfsnaam, je naam, je e-mailadres en een wachtwoord in. Je wordt eigenaar van het bedrijf. Houd de link privé: hij verloopt na 24 uur en de houder kan deze installatie ermee claimen.
Het script bewaart de installatiestatus standaard in /var/lib/appsweet.
Stap 3 — configureer AppSweet
Stel in de console de app-, console- en bestandsadressen, bestandsopslag, uitgaande e-mail en back-ups in. Gebruik de meegeleverde opslag of je eigen S3-compatibele provider. Voor de meegeleverde opslag hoef je geen toegangssleutels te genereren.
Verstuur de test-e-mail bij E-mail; je mailserver moet TLS of STARTTLS gebruiken. Versleutelde back-ups hebben een S3-compatibel doel buiten deze server nodig. Stel je back-ups uit, dan blijven updates onbeschikbaar totdat er een recente geverifieerde back-up is.
Instellingen worden als concept opgeslagen. Voer de controles uit en herstel gemelde DNS-, SMTP- of opslagproblemen voordat je ze toepast.
Stap 4 — start het
- Controleren & toepassen. Nu starten de services van AppSweet.
- Bevestig je wachtwoord. Daarmee maak je je eigenaarsaccount in de app aan, met hetzelfde e-mailadres en wachtwoord.
- Bewaar de herstelsleutel.
- Bedrijf activeren. Daarvoor is een geslaagde test-e-mail nodig.
- Installeer AppSweet voor Mac, voer het bedrijfseindpunt in dat de console toont en meld je aan.
Gebruik de console voor latere wijzigingen en updates. Vanaf dan wijzig je je consolewachtwoord en je app-wachtwoord los van elkaar.
Een onderbroken installatie opnieuw proberen
Herstel de gemelde voorwaarde en voer hetzelfde commando opnieuw uit. De gekozen release, installatie-identiteit en gegenereerde sleutels blijven bewaard. Na de eerste voltooide installatie kom je terug bij de console zonder de ingestelde deployment te vervangen.
Verloopt de claimlink terwijl de installatie nog niet geclaimd is, voeg dan
--renew-claim toe aan hetzelfde commando. Dit geeft een nieuwe link zonder een
bestaande beheerder opnieuw in te stellen. Verwijder nooit deploymentvolumes om
opnieuw te installeren.
Vernieuw voor de standaard alfa-installatie een ongebruikte claimlink met:
curl -fsSL https://releases.appsweet.app/install.sh | sh -s -- --channel alpha --renew-claim
Zie Problemen oplossen voor veelvoorkomende fouten.