# floci

> floci is a suite of free, MIT-licensed local cloud emulators for AWS, Azure, GCP, and OCI.
> No account required. No auth tokens. Runs entirely on your laptop.
> Built with Quarkus Native: 24 ms startup, ~13 MiB idle memory.

## Products

### floci (AWS)
- URL: https://floci.io/aws/
- GitHub: https://github.com/floci-io/floci
- 126 emulated AWS services on port 4566
- Drop-in LocalStack replacement: same AWS SDK endpoint override, same CLI flags
- 138× faster startup than LocalStack, 91% less memory

Supported services include: S3, SQS, SNS, DynamoDB, Lambda, API Gateway, IAM, KMS,
Secrets Manager, SSM Parameter Store, CloudFormation, EventBridge, Step Functions,
Kinesis, Firehose, ElastiCache, RDS, Aurora, Cognito, SES, STS, Redshift, EFS,
Organizations, IAM Identity Center, Resource Access Manager, Service Catalog,
Service Quotas, Control Tower, Lake Formation, EMR Serverless, Network Firewall,
Route 53 Resolver, Managed Prometheus, Amazon Connect, Comprehend, Rekognition,
Resource Explorer, Fault Injection Service, CodeGuru Reviewer, Security Hub,
Inspector, Macie, Detective, Verified Permissions, IAM Access Analyzer, DataSync,
Global Accelerator, Translate, AWS Budgets, AWS Marketplace, and more.

### floci-az (Azure)
- URL: https://floci.io/az/
- GitHub: https://github.com/floci-io/floci-az
- 29 emulated Azure services on port 4577
- MIT license: no Azurite license restrictions

Supported services include: Blob Storage, Queue Storage, Table Storage, Azure Functions,
App Configuration, Key Vault, Event Hubs, Service Bus, Cosmos DB, AKS, Azure SQL,
Virtual Machines, Cache for Redis, Entra ID, Event Grid, PostgreSQL, MySQL, MariaDB,
Container Instances, Container Apps, SignalR, Microsoft Graph, Azure Policy, and more.

### floci-gcp (Google Cloud)
- URL: https://floci.io/gcp/
- GitHub: https://github.com/floci-io/floci-gcp
- 27 emulated GCP services on port 4588
- No project ID or billing account required

Supported services include: Cloud Storage, Pub/Sub, Firestore, Datastore, Secret Manager,
IAM, Cloud Tasks, Cloud Scheduler, Cloud Run, Cloud SQL, Cloud Functions, Cloud KMS,
Compute Engine, GKE, BigQuery, Managed Kafka, and more.

### floci-oci (Oracle Cloud)
- URL: https://floci.io/oci/
- GitHub: https://github.com/floci-io/floci-oci
- 8 emulated OCI services on port 4599
- No Oracle Cloud account or uploaded API keys required

Supported services: Object Storage, Identity (IAM), Queue, Streaming, KMS,
Vault Secrets, Functions, OKE.

## Key Facts

- License: MIT (all four products)
- Free forever: no paid tiers, no feature gates
- Stable releases on the 15th and the last day of each month; `nightly` tags track main
- Runs as a container (Docker or Podman): each emulator is a GraalVM native image, started by floci-cli or `docker run`
- Works with all official AWS / Azure / GCP / OCI SDKs by pointing the endpoint URL to localhost
- No internet access required at runtime
- Designed for local development, CI/CD pipelines, and integration tests

## Quick Start

```sh
# AWS
docker run -p 4566:4566 floci/floci

# Azure
docker run -p 4577:4577 floci/floci-az

# GCP
docker run -p 4588:4588 floci/floci-gcp

# OCI
docker run -p 4599:4599 floci/floci-oci
```

## Docs and Guides

- AWS product page: https://floci.io/aws/
- Azure product page: https://floci.io/az/
- GCP product page: https://floci.io/gcp/
- OCI product page: https://floci.io/oci/
- Hands-on labs (no cloud account needed): https://floci.io/labs/
- Engineering chronicle: https://floci.io/chronicle/
- Compare floci vs LocalStack: https://floci.io/compare/

## Contact

- Contact form (sponsorship, enterprise and support, partnerships, press): https://floci.io/contact/
- Email: contact@floci.io
- Bugs and feature requests: GitHub issues in the relevant repo under https://github.com/floci-io