floci
★ 31.3kAbout
Community Ratings
No ratings yetNew this week
Read recap →Features
- Local AWS services
- AWS SDK/CLI/Terraform/CDK compatibility
- Drop-in LocalStack replacement
- Web console
- Real Docker-backed execution
- Configurable persistence
- Native binary
Details
- Last Updated
- Nov 11, 2026
- Created
- Feb 18, 2026
- Install Methods
- docker-composebinarypackage-manager
- Requirements
- Docker
- Minimum Requirements
- RAM: 13 MiBDisk: 40 MB
- Default Port
- 4566AWS emulator and web UI
- Authentication
- local
- API
- RESTWEBSOCKET
- Backup & Export
- file-backup
- Privacy & Independence
- No Cloud RequiredOffline Capable
- Deployment
Deployment: Docker Compose ✓Single Container — minimal hosting footprintsingle container
Run floci yourself
Pick how much you want to manage.
netcupBest match
Full control
A server with up to 1 GB of RAM, then Docker Compose.
About 20 minutes with Docker
Hetzner
Full control
A server with up to 1 GB of RAM, then Docker Compose.
About 20 minutes with Docker
DigitalOcean
Full control
A server with up to 1 GB of RAM, then Docker Compose.
About 20 minutes with Docker
Some links earn us a commission. netcup pays us one and is our preferred VPS host.
Is this your project? Sponsor a listing
Run floci with Docker Compose
Compose file from the floci project repository.
1 service
no resource limits declared
needs persistent storage (2 volumes)
docker-compose.yml · @ 4032efd · scanned Nov 3, 2026
services:
floci:
build:
context: .
dockerfile: docker/Dockerfile
tty: true
ports:
- "4566:4566"
- "6379-6399:6379-6399"
- "7001-7099:7001-7099"
- "9200-9299:9200-9299"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./data:/app/data
environment:
FLOCI_SERVICES_DOCKER_NETWORK: floci_default
FLOCI_SERVICES_RDS_PROXY_BASE_PORT: "7001"
# FLOCI_STORAGE_HOST_PERSISTENT_PATH is no longer needed.
# Floci now uses named Docker volumes by default.
# If you were using this env var for persistence, migrate: docker volume ls -f label=floci=true
FLOCI_HOSTNAME: floci
FLOCI_BASE_URL: http://floci:4566
# localhost.floci.io resolves everywhere: public DNS -> 127.0.0.1 on the host
# (reaching the published proxy ports), the network alias below inside Compose.
FLOCI_SERVICES_ELASTICACHE_CLUSTER_ANNOUNCE_HOSTNAME: localhost.floci.io
FLOCI_SERVICES_LAMBDA_HOT_RELOAD_ENABLED: "true"
# Match the compatibility workflow (.github/workflows/compatibility.yml) so the
# local Docker test run exercises the same Floci configuration as CI.
# TLS proxy serves HTTP and HTTPS on the same port 4566 (first-byte sniffing),
# so no extra port mapping is needed — this is what makes the TLS/HTTPS suites pass.
FLOCI_TLS_ENABLED: "true"
networks:
floci_default:
aliases:
- localhost.floci.io
networks:
floci_default:
name: floci_default
This file may be out of date. Check the floci documentation for current setup steps.
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.