---
title: "Deploy Floci"
description: "Floci 2.1 AWS emulator for S3, SQS, DynamoDB and more, with a gateway."
category: "Other"
url: https://railway.com/deploy/floci-1
---

# Deploy Floci

Floci 2.1 AWS emulator for S3, SQS, DynamoDB and more, with a gateway.

**[Deploy Floci on Railway](https://railway.com/template/floci-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/floci-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### gateway https://github.com/floci-io.png

- **Image:** caddy:2.11.4-alpine
- **Start command:** `sh -c 'printf "%s\n" "$CADDYFILE" > /tmp/Caddyfile && exec caddy run --config /tmp/Caddyfile --adapter caddyfile'`
- **Health check:** /gateway_health
- **Public domain:** Yes

### floci https://github.com/floci-io.png

- **Image:** floci/floci:2.1.0
- **Start command:** `/usr/local/bin/docker-entrypoint.sh /app/application -Dquarkus.http.host=::`
- **Health check:** /_floci/health

## Documentation

# Deploy and Host Floci on Railway

Floci is a free, open-source AWS emulator. It serves S3, SQS, SNS, DynamoDB, Secrets Manager, SSM, IAM, API Gateway, Kinesis and many other AWS APIs on one endpoint, so AWS SDKs, the AWS CLI, Terraform, CDK and test suites run against it without an AWS account or paid feature gates.

## About Hosting Floci

This template deploys Floci 2.1.0 with persistent storage on a Railway volume, so buckets, queues and tables survive redeploys. Floci itself stays on the private network, where services in your project reach it directly. A small Caddy gateway exposes it publicly and only forwards signed requests whose access key ID matches a generated key, because Floci does not check signatures. Point CI jobs, preview environments or your laptop at the gateway. Services that need a Docker daemon, such as Lambda, RDS or ECS, are not available on Railway. It fits the Hobby plan. Clients use any secret access key.

## Common Use Cases

- Integration tests against S3, SQS and DynamoDB without an AWS account
- A shared AWS-compatible backend for preview and staging environments
- Developing Terraform or CDK stacks before deploying to AWS

## Dependencies for Floci Hosting

- `floci/floci:2.1.0` (official image) with a volume
- `caddy:2.11.4-alpine` as the authenticating gateway

### Deployment Dependencies

- [Floci documentation](https://floci.io/floci/)
- [Floci 2.1.0 release](https://github.com/floci-io/floci/releases/tag/2.1.0)
- [Environment variables](https://floci.io/floci/configuration/environment-variables/)
- [Railway private networking](https://docs.railway.com/reference/private-networking)

### Implementation Details

| Service | Image | Networking | Storage |
| --- | --- | --- | --- |
| gateway | `caddy:2.11.4-alpine` | public domain on 8080 | none |
| floci | `floci/floci:2.1.0` | private only, port 4566 | volume at `/app/data` |

```bash
export AWS_ACCESS_KEY_ID= AWS_SECRET_ACCESS_KEY=any AWS_DEFAULT_REGION=us-east-1
aws --endpoint-url https:// s3 mb s3://uploads
aws --endpoint-url https:// sqs create-queue --queue-name jobs
```

| Variable | Service | Default | Purpose |
| --- | --- | --- | --- |
| `FLOCI_ACCESS_KEY_ID` | gateway | generated | The only access key ID the gateway accepts |
| `FLOCI_STORAGE_MODE` | floci | `persistent` | Keep state on the volume |
| `FLOCI_BASE_URL` | floci | gateway URL | URLs returned by the API, such as SQS queue URLs |

Notes:

- The access key ID acts as the password; the secret access key can be any value.
- Presigned URLs are refused by the gateway because they would reveal the key; they work over the private network at `${{floci.FLOCI_PRIVATE_ENDPOINT}}`.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Floci project or its maintainers.

## Why Deploy Floci on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Floci on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/floci-1