floci-io/floci

O que é?

Recursos principais

• 01Funciona com AWS SDKs, CLI e ferramentas de IaC padrão alterando apenas o endpoint.
• 02Executa Lambda, RDS, ElastiCache, ECS, EC2 e EKS como serviços reais baseados em Docker.
• 03Oferece modos de armazenamento em memória, persistente, híbrido e write-ahead log.
• 04Isola recursos por conta usando um access key ID de 12 dígitos.
• 05Oferece módulos do Testcontainers para Java, Node.js, Python e .NET.

Casos de uso

• Executar localmente código de aplicações e testes que dependem da AWS, sem precisar de uma conta na nuvem.
• Executar pipelines de CI com serviços da AWS emulados, em vez de infraestrutura real.
• Testar configurações de Terraform, CDK ou OpenTofu antes de implantar na AWS.
• Substituir o LocalStack Community em configurações existentes do Docker Compose.

Início rápido

1. 1

   Inicie o Floci com a CLI oficial

   floci start
2. 2

   Exporte as variáveis de ambiente da AWS

   eval $(floci env)
3. 3

   Execute comandos padrão da AWS CLI no Floci

   aws s3 mb s3://my-bucket

Antes de usar

• !Alguns serviços usam execução real baseada em Docker, então precisam de um mecanismo do Docker em execução e acesso ao socket do Docker.
• !O recurso "Web Console" do README exige que o socket do Docker seja montado no contêiner.

Tópicos

Perguntas frequentes

O que é floci?

Um emulador local da AWS gratuito e de código aberto para executar serviços compatíveis com AWS na sua máquina, sem conta ou token de autenticação. Floci é um emulador local da AWS para desenvolvimento, testes e CI. Basta apontar o AWS SDK, CLI, Terraform, CDK, OpenTofu ou sua suíte de testes para http://localhost:4566 e continuar usando os fluxos de trabalho existentes, sem precisar de uma conta na nuvem, token de autenticação ou planos pagos com recursos limitados.

floci é gratuito? Qual é a licença?

floci é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

floci ainda é mantido?

Manutenção ativa. O último commit de floci foi em 20 de out. de 2026.

Para que posso usar floci?

Executar localmente código de aplicações e testes que dependem da AWS, sem precisar de uma conta na nuvem. Executar pipelines de CI com serviços da AWS emulados, em vez de infraestrutura real. Testar configurações de Terraform, CDK ou OpenTofu antes de implantar na AWS. Substituir o LocalStack Community em configurações existentes do Docker Compose.

Como instalar floci?

Inicie o Floci com a CLI oficial: floci start Exporte as variáveis de ambiente da AWS: eval $(floci env) Execute comandos padrão da AWS CLI no Floci: aws s3 mb s3://my-bucket

Onde consigo floci?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/floci-io/floci