ASD Sandbox draaien met Docker

De ASD Sandbox is een kant-en-klare Docker image met de ASD CLI, een web terminal (ttyd), VS Code in de browser (code-server) en Caddy reverse proxy. Draai het lokaal of in CI voor een volledige development omgeving met tunnel exposure in één commando.

Wat je krijgt

• ASD CLI — voorgeïnstalleerd en klaar voor gebruik

• Web terminal (ttyd) — shell toegang via de browser

• VS Code (code-server) — volledige IDE in je browser

• Tunnel exposure — maak lokale poorten bereikbaar via een publieke HTTPS URL

• Caddy proxy — automatische HTTPS en reverse proxying

Vereisten

• Docker geïnstalleerd

• Een ASD API key ([asd.host/workspace/api-keys](https://asd.host/workspace/api-keys))

Quick start — interactieve modus

Draai de sandbox interactief met je project gemount:

docker run -it --name asd-sandbox --network host \
  -e ASD_API_KEY=your_api_key_here \
  -v $(pwd):/workspace \
  asd-stack.cr.de-fra.ionos.com/asd-sandbox:latest autostart

Dit start de sandbox, provisioneert credentials en opent een shell in de container. Je projectbestanden zijn beschikbaar op /workspace.

Een poort exposen

Expose een lokale poort en krijg direct een publieke tunnel URL:

# Expose poort 3000
docker run -it --name asd-sandbox --network host \
  -e ASD_API_KEY=your_api_key_here \
  -v $(pwd):/workspace \
  asd-stack.cr.de-fra.ionos.com/asd-sandbox:latest autostart expose 3000

De sandbox start, provisioneert credentials en exposeert poort 3000 via een beveiligde HTTPS tunnel. De URL wordt geprint naar stdout.

Exposen met een custom subdomein

Voeg een naam toe voor een herkenbare URL:

# Expose poort 3000 als "myapp"
# Resultaat: https://myapp-<jij>.eu1.tn.asd.engineer
docker run -it --name asd-sandbox --network host \
  -e ASD_API_KEY=your_api_key_here \
  -v $(pwd):/workspace \
  asd-stack.cr.de-fra.ionos.com/asd-sandbox:latest autostart expose 3000 myapp

Exposen via environment variable

Stel de expose poort in via environment variabelen — handig voor docker-compose of CI:

docker run -it --name asd-sandbox --network host \
  -e ASD_API_KEY=your_api_key_here \
  -e ASD_EXPOSE_PORT=3000 \
  -e ASD_EXPOSE_PREFIX=myapp \
  -v $(pwd):/workspace \
  asd-stack.cr.de-fra.ionos.com/asd-sandbox:latest autostart

Achtergrond modus

Draai de sandbox op de achtergrond en verbind later:

# Start op achtergrond
docker run -d --name asd-sandbox --network host \
  -e ASD_API_KEY=your_api_key_here \
  -v $(pwd):/workspace \
  asd-stack.cr.de-fra.ionos.com/asd-sandbox:latest autostart

# Verbind later
docker exec -it asd-sandbox bash

Docker

Compose

Voeg de sandbox toe aan je docker-compose.yml:

services:
  asd-sandbox:
    image: asd-stack.cr.de-fra.ionos.com/asd-sandbox:latest
    network_mode: host
    restart: unless-stopped
    environment:
- ASD_API_KEY=${ASD_API_KEY}
    volumes:
      - .:/workspace
    command: autostart

Start dan met docker compose up.

Environment variabelen

Variabele	Beschrijving	Verplicht
ASD_API_KEY	API key met tunnel credentials	Ja
ASD_EXPOSE_PORT	Poort om te exposen via tunnel	Nee
ASD_EXPOSE_PREFIX	Subdomein prefix voor de tunnel URL	Nee

Wat nu

[Lokale services exposen](/nl/howto/expose-local-services) — meerdere services, custom subdomeinen

[DevInCi instellen in

GitHub Actions](/nl/howto/devinci-setup) — geautomatiseerd CI debuggen

DevInCi instellen in GitLab CI/CD — GitLab pipeline debugging