Raised: $0
0% of monthly goal Help us cross the finish line!
Goal: $12,000
Raised: $0 Goal: $12,000
0% of monthly goal Help us cross the finish line!
Sponsor DDEV

If you find this add-on useful, please star it on GitHub — stars show appreciation and help maintainers know their work matters.

add-on registry tests last commit release

DDEV Fakecloud

Overview

This add-on integrates Fakecloud into your DDEV project.

fakecloud gives you a local AWS environment that behaves like infrastructure, not a mock. Your app uses the regular AWS SDK, CLI, and IaC tools. Unlike today’s LocalStack Community setup, you do not need an account, auth token, or paid plan just to keep core development flows local.

Installation

ddev add-on get tyler36/fakecloud
ddev restart

After installation, make sure to commit the .ddev directory to version control.

Usage

This addon:

Commands

Command Description
ddev fakecloud Command to run integrated fakecloud, overrides aws ENVs
  Aliases: ddev aws-fake, ddev fc
ddev aws Command to run integrated AWS-CLI.
ddev describe View service status and used ports for Fakecloud
ddev logs -s fakecloud Check Fakecloud logs

Note

This addon installs aws-cli inside the web container. You are responsible for managing its authentication and secrets.

Advanced Customization

To change the Docker image:

ddev dotenv set .ddev/.env.fakecloud --fakecloud-docker-image="ghcr.io/faiscadev/fakecloud:latest"
ddev add-on get tyler36/fakecloud
ddev restart

Make sure to commit the .ddev/.env.fakecloud file to version control.

All customization options (use with caution):

Variable Flag Default
FAKECLOUD_DOCKER_IMAGE --fakecloud-docker-image ghcr.io/faiscadev/fakecloud:latest

Credits

Contributed and maintained by @tyler36

If you find this add-on useful, please star it on GitHub — stars show appreciation and help maintainers know their work matters.