Skip to main content
Floci emulates 25 AWS services on a single port (4566). All services use the real AWS wire protocol — your existing AWS CLI commands and SDK clients work without modification.

Service Matrix

ServiceOperationsRuntimeProtocolNotable Features
SSM Parameter Store12FlociJSON 1.1Version history, labels, SecureString, tagging
SQS20FlociQuery / JSONStandard & FIFO, DLQ, visibility timeout, batch, tagging
SNS17FlociQuery / JSONTopics, subscriptions, SQS / Lambda / HTTP delivery, tagging
S350+FlociREST XMLVersioning, multipart upload, pre-signed URLs, Object Lock, event notifications
DynamoDB20FlociJSON 1.1GSI / LSI, Query, Scan, TTL, transactions, batch operations
DynamoDB Streams4FlociJSON 1.1Shard iterators, records, Lambda ESM trigger
Lambda18DockerREST JSONWarm pool, aliases, SQS / Kinesis / DDB Streams ESM
API Gateway REST40+FlociREST JSONResources, methods, stages, Lambda proxy, MOCK integrations
API Gateway v2 (HTTP)20FlociREST JSONRoutes, integrations, JWT authorizers, stages
IAM65+FlociQueryUsers, roles, groups, policies, instance profiles, access keys
STS7FlociQueryAssumeRole, WebIdentity, SAML, GetFederationToken, GetSessionToken
Cognito24FlociJSON 1.1User pools, app clients, auth flows, JWKS / OpenID well-known endpoints
KMS18FlociJSON 1.1Encrypt / decrypt, sign / verify, data keys, aliases
Kinesis21FlociJSON 1.1Streams, shards, enhanced fan-out, split / merge
Secrets Manager14FlociJSON 1.1Versioning, resource policies, tagging
Step Functions12FlociJSON 1.1ASL execution, task tokens, execution history
CloudFormation20FlociQueryStacks, change sets, resource provisioning
EventBridge14FlociJSON 1.1Custom buses, rules, targets (SQS / SNS / Lambda)
CloudWatch Logs14FlociJSON 1.1Log groups, streams, ingestion, filtering
CloudWatch Metrics8FlociQuery / JSONCustom metrics, statistics, alarms
ElastiCache8DockerQuery + RESPRedis / Valkey, IAM auth, SigV4 validation
RDS13DockerQuery + wirePostgreSQL & MySQL & MariaDB, IAM auth, JDBC-compatible
ACM12FlociJSON 1.1Certificate issuance, validation lifecycle
SES14FlociQuerySend email / raw email, identity verification, DKIM attributes
OpenSearch24FlociREST JSONDomain CRUD, tags, versions, instance types, upgrade stubs
Lambda, ElastiCache, and RDS spin up real Docker containers. They require the Docker socket to be mounted:
volumes:
  - /var/run/docker.sock:/var/run/docker.sock

Common Setup

Before calling any service, configure your AWS client to point to Floci:
export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_DEFAULT_REGION=us-east-1
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
All services respond on http://localhost:4566. Any region name and any credentials work — Floci does not validate them.

Service Categories

Compute

Lambda, API Gateway v1 (REST), and API Gateway v2 (HTTP)

Messaging

SQS, SNS, EventBridge, and Kinesis

Storage

S3, DynamoDB, DynamoDB Streams, Secrets Manager, and SSM Parameter Store

Security

IAM, STS, Cognito, KMS, and ACM

Networking

SES and OpenSearch

Observability

CloudWatch Logs, CloudWatch Metrics, Step Functions, and CloudFormation

Databases

ElastiCache (Redis / Valkey) and RDS (PostgreSQL / MySQL / MariaDB)

Build docs developers (and LLMs) love