Alfareleases zijn voorlopige versies voor evaluatie in een niet-productieomgeving.
Voordat je begint
Je hebt Dokploy 0.30.5 nodig en installeert op de lokale server met het standaardnetwerk dokploy-network, het entrypoint websecure en de certificaatresolver letsencrypt. De server heeft 4 CPU's, 8 GB geheugen, 40 GiB vrije schijfruimte en bereikbare poorten 80 en 443 nodig. Laat een DNS-naam voor de console, zoals console.example.com, naar de server wijzen. De adressen voor de app en de bestanden kies je later in de console.
1. Maak de Compose-service
Maak in een Dokploy-project een Compose-service. Kies op General de bron Raw, plak de installer hieronder ongewijzigd en sla op. Laat Domains leeg en behoud de App Name van de service.
Download de huidige alfa-installer. Open het gedownloade JSON-bestand als tekst en plak de volledige inhoud.
2. Maak een Dokploy-API-sleutel
Open in Dokploy je Profile en maak een API-sleutel met de naam appsweet-installer. Kopieer de sleutel.
3. Vul Environment in
Open Environment van de service, plak dit blok en vervang de eerste drie waarden:
APPSWEET_CONSOLE_HOSTNAME: de DNS-naam van de console, zonderhttps://.APPSWEET_DOKPLOY_SERVICE_URL: het adres in je browser terwijl je deze Compose-service in Dokploy bekijkt.APPSWEET_DOKPLOY_API_KEY: de API-sleutel uit stap 2.
APPSWEET_CONSOLE_HOSTNAME=console.example.com APPSWEET_DOKPLOY_SERVICE_URL=PASTE_THIS_SERVICE_PAGE_URL APPSWEET_DOKPLOY_API_KEY=PASTE_YOUR_DOKPLOY_API_KEY APPSWEET_INSTALLATION_KEY=PASTE_A_NEW_48_CHARACTER_KEY
Vervang de laatste waarde door een nieuwe installatiesleutel: 32–128 tekens met letters, cijfers, _ of -. Laat je wachtwoordmanager 48 tekens genereren met letters en cijfers en zonder symbolen.
Sla op. Bewaar ook de installatiesleutel, de laatste waarde, in je wachtwoordmanager: daarmee claim je de console.
4. Deploy en richt AppSweet in
Druk één keer op Deploy. Een tweede deployment volgt automatisch.
Open https://<consolehostnaam>/ en claim de installatie binnen 24 uur: vul de installatiesleutel, je bedrijfsnaam, je naam, je e-mailadres en een wachtwoord in. Je wordt eigenaar van het bedrijf.
Volg daarna de console:
- Adressen, Opslag en E-mail. Verstuur de test-e-mail; je mailserver moet TLS of STARTTLS gebruiken.
- Back-ups & herstel.
- 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 tot slot AppSweet voor Mac, voer het bedrijfseindpunt in dat de console toont en meld je aan.
Na de installatie vervangt AppSweet de API-sleutel door een eigen sleutel en verwijdert appsweet-installer. Vanaf dan wijzig je je consolewachtwoord en je app-wachtwoord los van elkaar.
Als er iets misgaat
- Behoud de service en de volumes. Verwijder nooit volumes om opnieuw te proberen.
- Voordat de console verschijnt: verbeter de waarde die het deploymentlog meldt, sla op en druk opnieuw op Deploy.
- Druk niet op Deploy terwijl een deployment in de wachtrij staat of draait.
- Een verloren installatiesleutel of een verlopen claim vereist herstel door de operator.
Zie Problemen oplossen voor meer.