Primi passi

Welcome to DownToZero Cloud! This guide will walk you through the steps to get started with our cloud services. Whether you’re a beginner or an experienced user, this guide covers the essential steps to begin leveraging the power of DownToZero Cloud.

Step 1: Create an Account

To begin using DownToZero Cloud, you first need to create an account:

  1. Go to DownToZero Cloud Signup.

    Modulo di registrazione

  2. Enter your email and password

  3. Click the Sign up button

  4. Once registered, you can log in via the DownToZero Cloud Login.

For cURL, please sign up via the Web UI, then generate an API key for API access.

  1. Go to New API Key.

    mostra la finestra di dialogo per la creazione di una chiave API

    Click the Create API key button

  2. Export the generated API key

    export DTZ_API_KEY=apikey-sample1234

Step 2: Enable the Container Services

  1. Enable the Container Services

    evidenzia il pulsante per abilitare il servizio container

  2. Open the Container Services

    mostra la panoramica dei Container Services

  1. Enable Container Services

    curl -X 'POST' -H "X-API-KEY: $DTZ_API_KEY" 'https://containers.dtz.rocks/api/2021-02-21/enable'

Step 3: Deploy NGINX as a service

  1. Select the Services section

    evidenzia la sezione Services nella navigazione superiore

  2. Click Create Service

    evidenzia il pulsante Create Service nell'interfaccia

  3. Enter the service details for NGINX

    evidenzia il pulsante per creare il servizio nell'interfaccia

    3.1. The prefix should be set to /. 3.2. The image should be set to nginx. 3.3. Click Create Service.

  4. evidenziato il link del servizio nell'interfaccia

  1. Create the service

    curl -X 'POST' \
'https://containers.dtz.rocks/api/2021-02-21/service' \
-H 'Content-Type: application/json' \
-H "X-API-KEY: $DTZ_API_KEY" \
-d '{"prefix": "/","containerImage": "nginx"}'
    This returns the following JSON. 
    {
    "contextId": "context-fxev27jf",
    "enabled": true,
    "serviceId": "service-ibok4vnd",
    "created": "2025-08-30T09:29:09.739001675Z",
    "updated": "2025-08-30T09:29:09.739002547Z",
    "prefix": "/",
    "containerImage": "nginx"
}

Step 4: Verify the deployment

  1. evidenziato il link del servizio nell'interfaccia

  2. Verify the NGINX deployment

    mostra una pagina di benvenuto generata da nginx

  1. Fetch the generated domain for your context.

    curl -H "X-API-KEY: $DTZ_API_KEY" 'https://containers.dtz.rocks/api/2021-02-21/domain'
    This returns the following JSON. 
    [{
    "contextId": "context-fxev27jf",
    "name": "fxev27jf.containers.dtz.dev",
    "verified": true,
    "created": "2025-08-30T08:45:26.656377567Z",
    "updated": "2025-08-30T08:45:26.656378477Z"
}]

  2. Use the name value as the domain to verify your deployment.

    curl "https://DOMAIN_NAME"

With this guide, you’re ready to start using DownToZero Cloud! Should you encounter any issues or have questions, please reach out to our support team at contact@downtozero.cloud.