https://github.com/capawesome-team/docker-cloud-api-proxy
🐳 Docker image template for self-hosting an nginx reverse proxy to the Capawesome Cloud API.
https://github.com/capawesome-team/docker-cloud-api-proxy
List: docker-cloud-api-proxy
capawesome capawesome-cloud docker live-updates nginx nginx-proxy ota ota-update proxy
Last synced: 6 days ago
JSON representation
🐳 Docker image template for self-hosting an nginx reverse proxy to the Capawesome Cloud API.
- Host: GitHub
- URL: https://github.com/capawesome-team/docker-cloud-api-proxy
- Owner: capawesome-team
- License: mit
- Created: 2026-06-13T07:03:24.000Z (11 days ago)
- Default Branch: main
- Last Pushed: 2026-06-13T07:34:20.000Z (11 days ago)
- Last Synced: 2026-06-13T09:07:45.177Z (11 days ago)
- Topics: capawesome, capawesome-cloud, docker, live-updates, nginx, nginx-proxy, ota, ota-update, proxy
- Language: Dockerfile
- Homepage: https://capawesome.io/cloud/
- Size: 2.93 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-cloud-api-proxy
🐳 Docker image for proxying requests from your own domain to the Capawesome Cloud API.
## Overview
This repository is a template for customers who want to host their own reverse proxy in front of the [Capawesome Cloud](https://capawesome.io/cloud) API. The proxy forwards incoming requests from your own domain to the official Capawesome Cloud API at `https://api.cloud.capawesome.io`.
A common reason to run your own proxy is to serve the API under a domain you control (for example, to keep all traffic on your own hostname).
For more details, see the [Request Proxying](https://capawesome.io/docs/cloud/live-updates/request-proxying/) documentation.
## How it works
The proxy is a minimal [nginx](https://nginx.org) container:
- **`default.conf`** – nginx server block that listens on port `80` and proxies all requests to the Capawesome Cloud API.
- **`Dockerfile`** – builds an image based on `nginx:latest` with the configuration above.
## Prerequisites
- [Docker](https://www.docker.com)
- A domain you control, pointing to the host that runs this container
## Getting started
Build the image:
```bash
docker build -t capawesome-team/cloud-api-proxy .
```
Run the image:
```bash
docker run -p 8080:80 capawesome-team/cloud-api-proxy
```
The proxy is now available at `http://localhost:8080` and forwards requests to the Capawesome Cloud API.
## Configuration
Edit `default.conf` to match your setup:
- **`server_name`** – Replace `api.cloud.capawesome.eu` with your own domain.
- **`proxy_pass`** – Leave this pointed at `https://api.cloud.capawesome.io` (the official Capawesome Cloud API).
After changing the configuration, rebuild the image for the changes to take effect.
> [!NOTE]
> This template terminates plain HTTP on port `80`. For production use, terminate TLS in front of the container (for example, via a load balancer or a reverse proxy such as Caddy, Traefik, or another nginx instance).
## License
See [LICENSE](./LICENSE).