Skip to content

armgit / floci

Public Imported from GitHub
0

Light, fluffy, and always free - The AWS Local Emulator alternative

Release 1.5.13

Hector Venturac444da222cb9
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 793f2f0caf..cc6d7359ca 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
+## [1.5.13] - 2026-05-07
+
### Added
- **backup:** AWS Backup Phase 1 — vaults, plans, selections, on-demand jobs with simulated CREATED→RUNNING→COMPLETED lifecycle, recovery points, tagging via `SharedTagsController`, and `GetSupportedResourceTypes`
@@ -547,7 +549,8 @@ Initial public release of Floci — a fast, free, open-source local AWS emulator
---
-[Unreleased]: https://github.com/floci-io/floci/compare/1.5.12...HEAD
+[Unreleased]: https://github.com/floci-io/floci/compare/1.5.13...HEAD
+[1.5.13]: https://github.com/floci-io/floci/compare/1.5.12...1.5.13
[1.5.12]: https://github.com/floci-io/floci/compare/1.5.11...1.5.12
[1.5.11]: https://github.com/floci-io/floci/compare/1.5.10...1.5.11
[1.5.10]: https://github.com/floci-io/floci/compare/1.5.9...1.5.10
diff --git a/README.md b/README.md
index ecc4c3ff47..ca17282c01 100644
--- a/README.md
+++ b/README.md
@@ -253,12 +253,13 @@ All default images are configurable via environment variables, useful for pinnin
| **Auto Scaling** | In-process + **background reconciler** | Launch configurations, auto scaling groups with min/max/desired capacity; background loop (10 s) calls `RunInstances` / `TerminateInstances` to meet desired capacity; lifecycle hooks, scaling policies, ELB v2 target group auto-registration |
| **AWS Backup** | In-process | Vaults, backup plans with rules, resource selections, on-demand jobs with simulated lifecycle (CREATED → RUNNING → COMPLETED), recovery points, tagging |
| **Route53** | In-process | Hosted zones with auto-created SOA + NS records, resource record sets (CREATE/UPSERT/DELETE with atomic validation), change tracking (always INSYNC), health checks, and per-resource tagging |
+| **Transfer Family** | In-process | Server lifecycle (`CreateServer` / `DeleteServer` / `StartServer` / `StopServer` / `UpdateServer`), user management, SSH public key import, and tagging |
> **Lambda, ElastiCache, RDS, MSK, ECS, EC2, EKS, OpenSearch, and CodeBuild** spin up real Docker containers and support IAM authentication and SigV4 request signing — the same auth flow as production AWS. **ECR** runs a shared `registry:2` container so the stock `docker` client can push and pull image bytes against repositories returned by the AWS-shaped control plane.
>
> For per-service operation counts and endpoint protocols, see the [Services Overview](https://floci.io/floci/services/) in the documentation site.
-**43 AWS services supported.**
+**45 AWS services supported.**
## Persistence & Storage Modes
diff --git a/docs/index.md b/docs/index.md
index ad7eff959f..7f3fc760f8 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -12,7 +12,7 @@ Floci is a fast, free, and open-source local AWS service emulator built for deve
## Supported Services
-Floci emulates 41 AWS services. See the [Services Overview](services/index.md) for per-service operation counts, endpoints, and full protocol details.
+Floci emulates 45 AWS services. See the [Services Overview](services/index.md) for per-service operation counts, endpoints, and full protocol details.
| Service | Protocol |
|---|---|
@@ -51,12 +51,12 @@ Floci emulates 41 AWS services. See the [Services Overview](services/index.md) f
| Bedrock Runtime | REST JSON |
| EKS | REST JSON |
| ELB v2 | Query |
-| MSK | REST JSON |
-| Athena | JSON 1.1 |
-| Glue | JSON 1.1 |
-| Data Firehose | JSON 1.1 |
+| Auto Scaling | Query |
| CodeBuild | JSON 1.1 |
| CodeDeploy | JSON 1.1 |
+| AWS Backup | REST JSON |
+| Route53 | REST XML |
+| Transfer Family | JSON 1.1 |
## Why Floci?
@@ -92,7 +92,7 @@ docker compose up -d
aws --endpoint-url http://localhost:4566 s3 mb s3://my-bucket
```
-All 41 AWS services are immediately available at `http://localhost:4566`.
+All 45 AWS services are immediately available at `http://localhost:4566`.
[Get started →](getting-started/quick-start.md){ .md-button .md-button--primary }
[View services →](services/index.md){ .md-button }
diff --git a/docs/services/index.md b/docs/services/index.md
index fa9a1aa37e..2d531e0075 100644
--- a/docs/services/index.md
+++ b/docs/services/index.md
@@ -1,6 +1,6 @@
# Services Overview
-Floci emulates 44 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.
+Floci emulates 45 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.
This page is the canonical reference for supported service and operation counts. Some services expose separate control-plane and data-plane rows below. Other docs (and the README) should link here rather than duplicating the table.
@@ -50,14 +50,11 @@ Operation counts are exact. For dispatch-table services (Query and JSON 1.1) eac
| [EKS](eks.md) | `/clusters`, `/clusters/{name}`, `/tags/{resourceArn}` | REST JSON | 7 |
| [ELB v2](elb.md) | `POST /` with `Action=` param | Query | 34 |
| [Auto Scaling](autoscaling.md) | `POST /` with `Action=` param | Query | 33 |
-| [MSK](msk.md) | `/v1/clusters/...`, `/api/v2/clusters/...` | REST JSON | 8 |
-| [Athena](athena.md) | `POST /` + `X-Amz-Target: AmazonAthena.*` | JSON 1.1 | 8 |
-| [Glue](glue.md) | `POST /` + `X-Amz-Target: AWSGlue.*` | JSON 1.1 | 15 |
-| [Data Firehose](firehose.md) | `POST /` + `X-Amz-Target: Firehose_20150804.*` | JSON 1.1 | 6 |
| [CodeBuild](codebuild.md) | `POST /` + `X-Amz-Target: CodeBuild_20161006.*` | JSON 1.1 | 20 |
| [CodeDeploy](codedeploy.md) | `POST /` + `X-Amz-Target: CodeDeploy_20141006.*` | JSON 1.1 | 30 |
| [AWS Backup](backup.md) | `/backup-vaults/*`, `/backup/plans/*`, `/backup-jobs/*`, `/supported-resource-types` | REST JSON | 20 |
| [Route53](route53.md) | `/2013-04-01/hostedzone/*`, `/2013-04-01/healthcheck/*`, `/2013-04-01/change/*` | REST XML | 17 |
+| [Transfer Family](transfer.md) | `POST /` + `X-Amz-Target: TransferService.*` | JSON 1.1 | 17 |
**Lambda, ElastiCache, RDS, MSK, ECS, EKS, and OpenSearch** spin up real Docker containers and support IAM authentication and SigV4 request signing, the same auth flow as production AWS.
diff --git a/docs/services/transfer.md b/docs/services/transfer.md
new file mode 100644
index 0000000000..8f2b60448a
--- /dev/null
+++ b/docs/services/transfer.md
@@ -0,0 +1,98 @@
+# Transfer Family
+
+**Protocol:** JSON 1.1
+**Endpoint:** `http://localhost:4566/`
+**X-Amz-Target prefix:** `TransferService.`
+
+## Supported Actions
+
+### Servers
+
+| Action | Description |
+|---|---|
+| `CreateServer` | Create an SFTP/FTP/FTPS server |
+| `DescribeServer` | Get server details and state |
+| `UpdateServer` | Update server configuration |
+| `DeleteServer` | Delete a server |
+| `ListServers` | List all servers |
+| `StartServer` | Start a stopped server (sets state to `ONLINE`) |
+| `StopServer` | Stop a running server (sets state to `OFFLINE`) |
+
+### Users
+
+| Action | Description |
+|---|---|
+| `CreateUser` | Create a user on a server |
+| `DescribeUser` | Get user details and SSH keys |
+| `UpdateUser` | Update user properties (home directory, role, policy) |
+| `DeleteUser` | Delete a user and all associated SSH keys |
+| `ListUsers` | List all users for a server |
+
+### SSH Public Keys
+
+| Action | Description |
+|---|---|
+| `ImportSshPublicKey` | Import an SSH public key for a user |
+| `DeleteSshPublicKey` | Remove an SSH public key from a user |
+
+### Tagging
+
+| Action | Description |
+|---|---|
+| `TagResource` | Add tags to a server or user |
+| `UntagResource` | Remove tags from a resource |
+| `ListTagsForResource` | List tags on a resource |
+
+## Configuration
+
+```yaml
+floci:
+ services:
+ transfer:
+ enabled: true
+```
+
+| Environment variable | Default | Description |
+|---|---|---|
+| `FLOCI_SERVICES_TRANSFER_ENABLED` | `true` | Enable or disable Transfer Family |
+
+## ARN Format
+
+| Resource | ARN |
+|---|---|
+| Server | `arn:aws:transfer:{region}:{account}:server/{serverId}` |
+| User | `arn:aws:transfer:{region}:{account}:user/{serverId}/{userName}` |
+
+## Example Usage
+
+```bash
+# Create a server
+aws --endpoint-url http://localhost:4566 transfer create-server \
+ --protocols SFTP
+
+# Create a user
+aws --endpoint-url http://localhost:4566 transfer create-user \
+ --server-id s-abc123 \
+ --user-name alice \
+ --role arn:aws:iam::000000000000:role/transfer-role \
+ --home-directory /alice
+
+# Import an SSH public key
+aws --endpoint-url http://localhost:4566 transfer import-ssh-public-key \
+ --server-id s-abc123 \
+ --user-name alice \
+ --ssh-public-key-body "ssh-rsa AAAA..."
+
+# List servers
+aws --endpoint-url http://localhost:4566 transfer list-servers
+
+# Start / stop a server
+aws --endpoint-url http://localhost:4566 transfer start-server --server-id s-abc123
+aws --endpoint-url http://localhost:4566 transfer stop-server --server-id s-abc123
+```
+
+## Notes
+
+- **Phase 1** covers the management-plane API only. Data-plane SFTP connectivity (actual file transfer) is not emulated.
+- Server `EndpointType` defaults to `PUBLIC`. The `State` field transitions between `ONLINE` and `OFFLINE` via `StartServer` / `StopServer`.
+- SSH key bodies are stored and returned as-is; no cryptographic validation is performed.
diff --git a/floci_banner.svg b/floci_banner.svg
index a23cbc929f..b7a5f5ab22 100644
--- a/floci_banner.svg
+++ b/floci_banner.svg
@@ -108,7 +108,7 @@
<!-- Stat 3: Services -->
<text x="770" y="548"
font-family="'Courier New', Courier, monospace"
- font-size="42" font-weight="700" fill="#ffe082" text-anchor="middle">~41
+ font-size="42" font-weight="700" fill="#ffe082" text-anchor="middle">~45
</text>
<text x="770" y="574"
font-family="'Helvetica Neue', Helvetica, Arial, sans-serif"
diff --git a/mkdocs.yml b/mkdocs.yml
index 2d38d48432..dae656dc01 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -102,6 +102,13 @@ nav:
- EC2: services/ec2.md
- AppConfig: services/appconfig.md
- Bedrock Runtime: services/bedrock-runtime.md
+ - ELB v2: services/elb.md
+ - Auto Scaling: services/autoscaling.md
+ - CodeBuild: services/codebuild.md
+ - CodeDeploy: services/codedeploy.md
+ - AWS Backup: services/backup.md
+ - Route53: services/route53.md
+ - Transfer Family: services/transfer.md
- Testcontainers:
- Overview: testcontainers/index.md
- Java: testcontainers/java.md
diff --git a/pom.xml b/pom.xml
index 5ae3cf5cf8..b110e78289 100644
--- a/pom.xml
+++ b/pom.xml
@@ -6,7 +6,7 @@
<groupId>io.github.hectorvent</groupId>
<artifactId>floci</artifactId>
- <version>1.5.12</version>
+ <version>1.5.13</version>
<packaging>jar</packaging>
<name>Floci</name>