Tools

Tools: Complete Guide to Migrating from LocalStack to fakecloud in 10 minutes

2026-04-23 0 views admin
Tools: Complete Guide to Migrating from LocalStack to fakecloud in 10 minutes

The one-line summary

Step 1: Stop LocalStack

Step 2: Install fakecloud

Step 3: Keep your SDK wiring

Step 4: Update docker-compose.yml

Step 5: Update GitHub Actions

Step 6: Terraform

Things that may need attention

Services that moved from LocalStack Community to Pro (and what fakecloud does)

Test-assertion SDKs (bonus)

Verify the migration Canonical: fakecloud.dev/blog/migrate-from-localstack In March 2026, LocalStack replaced its open-source Community Edition with a proprietary image that requires an account and an auth token. If your build broke last month, this guide is for you. If you are still on a pinned older tag and worried about the next pull, this is also for you. fakecloud is a free, open-source AWS emulator — single binary, no account, no token, no paid tier — that covers the services most teams relied on LocalStack Community for, plus several that moved to LocalStack Pro (RDS, ElastiCache, Cognito User Pools, SES v2, API Gateway v2). This guide is step-by-step. Copy, paste, done. Change the image or the install command. Keep http://localhost:4566 and your dummy credentials. Everything else stays the same. fakecloud listens on http://localhost:4566 — same as LocalStack. Your application code does not change. Endpoint URL and dummy credentials stay identical: fakecloud starts all services by default (they are lazy and cheap — no SERVICES env var needed). For Lambda execution you will need Docker-in-Docker or a mounted Docker socket (same as LocalStack Pro required): After (install-and-run, no Docker): ~500ms startup vs ~3s for LocalStack container boot. On a cold CI runner the difference adds up over hundreds of test runs. Provider block stays the same — only the running emulator changes. fakecloud's CI runs the upstream hashicorp/terraform-provider-aws TestAcc* suites against itself, so Terraform flows that worked against LocalStack Community should work against fakecloud. fakecloud ships test-assertion SDKs that let you inspect side effects from tests without raw HTTP: SDKs for TypeScript, Python, Go, PHP, Java, Rust. See the SDK docs. If it works, migration is done. Templates let you quickly answer FAQs or store snippets for re-use. Hide child comments as well For further actions, you may consider blocking this person and/or reporting abuse

Command

Copy

$ -weight: 500;">docker compose down # or: -weight: 500;">docker kill $(-weight: 500;">docker ps -q --filter ancestor=localstack/localstack) -weight: 500;">docker compose down # or: -weight: 500;">docker kill $(-weight: 500;">docker ps -q --filter ancestor=localstack/localstack) -weight: 500;">docker compose down # or: -weight: 500;">docker kill $(-weight: 500;">docker ps -q --filter ancestor=localstack/localstack) # Option A: single binary, no Docker -weight: 500;">curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/-weight: 500;">install.sh | bash fakecloud # Option B: Docker -weight: 500;">docker run --rm -p 4566:4566 ghcr.io/faiscadev/fakecloud # Option C: cargo cargo -weight: 500;">install fakecloud # Option A: single binary, no Docker -weight: 500;">curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/-weight: 500;">install.sh | bash fakecloud # Option B: Docker -weight: 500;">docker run --rm -p 4566:4566 ghcr.io/faiscadev/fakecloud # Option C: cargo cargo -weight: 500;">install fakecloud # Option A: single binary, no Docker -weight: 500;">curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/-weight: 500;">install.sh | bash fakecloud # Option B: Docker -weight: 500;">docker run --rm -p 4566:4566 ghcr.io/faiscadev/fakecloud # Option C: cargo cargo -weight: 500;">install fakecloud // TypeScript import { S3Client } from "@aws-sdk/client-s3"; const s3 = new S3Client({ endpoint: "http://localhost:4566", region: "us-east-1", credentials: { accessKeyId: "test", secretAccessKey: "test" }, forcePathStyle: true, }); // TypeScript import { S3Client } from "@aws-sdk/client-s3"; const s3 = new S3Client({ endpoint: "http://localhost:4566", region: "us-east-1", credentials: { accessKeyId: "test", secretAccessKey: "test" }, forcePathStyle: true, }); // TypeScript import { S3Client } from "@aws-sdk/client-s3"; const s3 = new S3Client({ endpoint: "http://localhost:4566", region: "us-east-1", credentials: { accessKeyId: "test", secretAccessKey: "test" }, forcePathStyle: true, }); # Python (boto3) import boto3 s3 = boto3.client( "s3", endpoint_url="http://localhost:4566", aws_access_key_id="test", aws_secret_access_key="test", region_name="us-east-1", ) # Python (boto3) import boto3 s3 = boto3.client( "s3", endpoint_url="http://localhost:4566", aws_access_key_id="test", aws_secret_access_key="test", region_name="us-east-1", ) # Python (boto3) import boto3 s3 = boto3.client( "s3", endpoint_url="http://localhost:4566", aws_access_key_id="test", aws_secret_access_key="test", region_name="us-east-1", ) services: localstack: image: localstack/localstack:latest ports: - "4566:4566" environment: - SERVICES=s3,sqs,sns,dynamodb,lambda - DEBUG=1 services: localstack: image: localstack/localstack:latest ports: - "4566:4566" environment: - SERVICES=s3,sqs,sns,dynamodb,lambda - DEBUG=1 services: localstack: image: localstack/localstack:latest ports: - "4566:4566" environment: - SERVICES=s3,sqs,sns,dynamodb,lambda - DEBUG=1 services: fakecloud: image: ghcr.io/faiscadev/fakecloud:latest ports: - "4566:4566" services: fakecloud: image: ghcr.io/faiscadev/fakecloud:latest ports: - "4566:4566" services: fakecloud: image: ghcr.io/faiscadev/fakecloud:latest ports: - "4566:4566" services: fakecloud: image: ghcr.io/faiscadev/fakecloud:latest ports: - "4566:4566" volumes: - /var/run/-weight: 500;">docker.sock:/var/run/-weight: 500;">docker.sock services: fakecloud: image: ghcr.io/faiscadev/fakecloud:latest ports: - "4566:4566" volumes: - /var/run/-weight: 500;">docker.sock:/var/run/-weight: 500;">docker.sock services: fakecloud: image: ghcr.io/faiscadev/fakecloud:latest ports: - "4566:4566" volumes: - /var/run/-weight: 500;">docker.sock:/var/run/-weight: 500;">docker.sock services: localstack: image: localstack/localstack ports: - 4566:4566 env: LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_TOKEN }} services: localstack: image: localstack/localstack ports: - 4566:4566 env: LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_TOKEN }} services: localstack: image: localstack/localstack ports: - 4566:4566 env: LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_TOKEN }} steps: - run: -weight: 500;">curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/-weight: 500;">install.sh | bash - run: fakecloud & - run: | for i in $(seq 1 30); do -weight: 500;">curl -sf http://localhost:4566/_fakecloud/health && exit 0 sleep 1 done exit 1 steps: - run: -weight: 500;">curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/-weight: 500;">install.sh | bash - run: fakecloud & - run: | for i in $(seq 1 30); do -weight: 500;">curl -sf http://localhost:4566/_fakecloud/health && exit 0 sleep 1 done exit 1 steps: - run: -weight: 500;">curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/-weight: 500;">install.sh | bash - run: fakecloud & - run: | for i in $(seq 1 30); do -weight: 500;">curl -sf http://localhost:4566/_fakecloud/health && exit 0 sleep 1 done exit 1 provider "aws" { access_key = "test" secret_key = "test" region = "us-east-1" skip_credentials_validation = true skip_metadata_api_check = true skip_requesting_account_id = true endpoints { s3 = "http://localhost:4566" sqs = "http://localhost:4566" dynamodb = "http://localhost:4566" lambda = "http://localhost:4566" } } provider "aws" { access_key = "test" secret_key = "test" region = "us-east-1" skip_credentials_validation = true skip_metadata_api_check = true skip_requesting_account_id = true endpoints { s3 = "http://localhost:4566" sqs = "http://localhost:4566" dynamodb = "http://localhost:4566" lambda = "http://localhost:4566" } } provider "aws" { access_key = "test" secret_key = "test" region = "us-east-1" skip_credentials_validation = true skip_metadata_api_check = true skip_requesting_account_id = true endpoints { s3 = "http://localhost:4566" sqs = "http://localhost:4566" dynamodb = "http://localhost:4566" lambda = "http://localhost:4566" } } import { FakeCloud } from "fakecloud"; const fc = new FakeCloud(); const { emails } = await fc.ses.getEmails(); expect(emails).toHaveLength(1); expect(emails[0].destination.toAddresses).toContain("[email protected]"); await fc.reset(); import { FakeCloud } from "fakecloud"; const fc = new FakeCloud(); const { emails } = await fc.ses.getEmails(); expect(emails).toHaveLength(1); expect(emails[0].destination.toAddresses).toContain("[email protected]"); await fc.reset(); import { FakeCloud } from "fakecloud"; const fc = new FakeCloud(); const { emails } = await fc.ses.getEmails(); expect(emails).toHaveLength(1); expect(emails[0].destination.toAddresses).toContain("[email protected]"); await fc.reset(); aws --endpoint-url http://localhost:4566 s3 mb s3://test-bucket echo hello | aws --endpoint-url http://localhost:4566 s3 cp - s3://test-bucket/hello.txt aws --endpoint-url http://localhost:4566 s3 ls s3://test-bucket/ aws --endpoint-url http://localhost:4566 s3 rb s3://test-bucket --force aws --endpoint-url http://localhost:4566 s3 mb s3://test-bucket echo hello | aws --endpoint-url http://localhost:4566 s3 cp - s3://test-bucket/hello.txt aws --endpoint-url http://localhost:4566 s3 ls s3://test-bucket/ aws --endpoint-url http://localhost:4566 s3 rb s3://test-bucket --force aws --endpoint-url http://localhost:4566 s3 mb s3://test-bucket echo hello | aws --endpoint-url http://localhost:4566 s3 cp - s3://test-bucket/hello.txt aws --endpoint-url http://localhost:4566 s3 ls s3://test-bucket/ aws --endpoint-url http://localhost:4566 s3 rb s3://test-bucket --force - SERVICES env var. Drop it. fakecloud starts all services by default. - LOCALSTACK_AUTH_TOKEN. Drop it. - Persisted state. LocalStack Pro has PERSISTENCE=1. fakecloud has --persist /path/to/dir. - Install: -weight: 500;">curl -fsSL https://raw.githubusercontent.com/faiscadev/fakecloud/main/-weight: 500;">install.sh | bash - Repo: github.com/faiscadev/fakecloud - Site: fakecloud.dev - Issues: github.com/faiscadev/fakecloud/issues

🏷️ Tags

toolsutilitiessecurity toolscompleteguidemigratinglocalstackfakecloudminutesrce

More from Tools

Tools: Essential Guide: Breaking Down Linux File-System

Tools: Essential Guide: Breaking Down Linux File-System

2026-04-23 0
Tools: Linux Never Hides Anything - Expert Insights

Tools: Linux Never Hides Anything - Expert Insights

2026-04-23 0
Tools: How to Cut LLM Token Spend with Semantic Caching: A Production Setup Guide (2026)

Tools: How to Cut LLM Token Spend with Semantic Caching: A Production Setup Guide (2026)

2026-04-23 0
Tools: Laravel Deployment for Beginners: What Actually Happens When You Click Deploy (2026)

Tools: Laravel Deployment for Beginners: What Actually Happens When You Click Deploy (2026)

2026-04-23 0

Trending

1

CVE-2025-61481: Critical Remote Code Execution Vulnerability in MikroTik RouterOS & SwitchOS

2025-10-27 • 189 views
2

CVE-2025-43939: Dell Unity OS Command Injection (High)

2025-10-30 • 148 views
3

Google disputes false claims of massive Gmail data breach

2025-10-30 • 130 views
4

Microsoft: DNS outage impacts Azure and Microsoft 365 services

2025-10-30 • 88 views
5

3.5B Accounts, 1 Critical Flaw: Meta Closes WhatsApp Data-Harvesting

2025-11-25 • 81 views