Merge pull request #18 from second-state/fly.io

Add Fly.io deployment config and update Dockerfile

Author: L-jasmine

docker/README.md

@@ -0,0 +1,54 @@
+This doc guides you through building and deploying the echokit_server container to Fly.io.
+
+## Prerequisites
+- flyctl installed: see https://github.com/superfly/flyctl
+- Docker installed and running locally
+- A unique Fly app name (Fly app names are globally unique)
+
+## 1) Create the Fly app
+```bash
+fly app create --name echokit-server-[something-unique]
+```
+
+## 2) Build the Docker image
+From the server-vad directory, ensure `config.toml` is valid, then build:
+```bash
+cd server-vad
+docker build -t registry.fly.io/[your_app_name]:tag .
+```
+
+## 3) Push the image to Fly
+Authenticate to the Fly registry and push the image:
+```bash
+fly auth docker
+docker push registry.fly.io/[your_app_name]:tag
+```
+
+## 4) Configure Fly to use the image
+Update `fly.toml` to point to `registry.fly.io/[your_app_name]:tag`.
+
+## 5) Deploy
+From the `docker` directory:
+```bash
+fly deploy
+```
+
+## Managing machines
+- Deploy creates two machines in the same region by default. Remove one if you only need a single instance:
+  ```bash
+  fly machine list           # get machine IDs
+  fly machine destroy [id]   # remove one
+  ```
+- To run in additional regions, clone a machine:
+  ```bash
+  fly platform regions                   # list region codes
+  fly machine clone [id] --region dfw    # example clone into DFW
+  ```
+
+## Quick checklist
+- [ ] flyctl installed and authenticated
+- [ ] Unique app name chosen
+- [ ] `config.toml` validated in `server-vad`
+- [ ] Image built and pushed to Fly registry
+- [ ] `fly.toml` updated with the pushed image tag
+- [ ] App deployed with `fly deploy`

docker/fly.toml

@@ -0,0 +1,22 @@
+# fly.toml app configuration file generated for echokit-server on 2025-11-25T18:57:15+08:00
+#
+# See https://fly.io/docs/reference/configuration/ for information about how to use this file.
+#
+
+app = 'echokit-server'
+
+[build]
+  image = 'registry.fly.io/echokit-server:latest-server-vad'
+
+[http_service]
+  internal_port = 8080
+  force_https = false
+  auto_stop_machines = 'stop'
+  auto_start_machines = true
+  min_machines_running = 0
+  processes = ['app']
+
+[[vm]]
+  memory = '1gb'
+  cpu_kind = 'shared'
+  cpus = 1

docker/server-vad/Dockerfile

@@ -5,7 +5,7 @@ FROM debian:bookworm-slim
 WORKDIR /app
 
 ARG TARGETPLATFORM
-ARG ECHOKIT_VERSION=0.1.0
+ARG ECHOKIT_VERSION=0.2.2
 ARG VAD_VERSION=0.1.0
 
 RUN set -eux; \
@@ -115,4 +115,6 @@ EOF
 
 ENV RUST_LOG=info
 
+EXPOSE 8080
+
 CMD ["/usr/local/bin/start_servers.sh"]