spoolersh/memspoolerd repository overview

⁠memspoolerd

Spooler⁠ is a managed message queue.

spoolersh/memspoolerd is that server on your own machines, with ephemeral in-memory storage. It needs no account and issues no API key. Nothing persists: every message is lost when the container exits. It is free to run for your own purposes, in development, in tests and in production; it may not be provided to others or hosted as a service. See License⁠.

⁠Run it

docker run --rm -p 127.0.0.1:8080:8080 spoolersh/memspoolerd

The API is at http://localhost:8080/v1. Any bearer token authenticates, which is why the port is bound to loopback.

Everything else, from the first request to what this image does and does not reproduce, is at docs.spooler.sh⁠:

• Running locally⁠ — what this image is and where it differs from the hosted service
• Quickstart⁠ — send, receive, ack
• API reference⁠ — every operation

⁠What is in the image

• The Spooler server with ephemeral in-memory storage. Not a mock and not a reimplementation.
• One static binary on FROM scratch: no shell, no package manager, no operating system. It runs as uid 65534 and makes no outbound connections.
• linux/amd64 and linux/arm64.
• One port, 8080. No environment variables. One optional mount, /etc/spooler/queues.d: each *.yaml file in it declares a queue to create at startup, so a restarted container has the queues your code expects. See Running locally⁠.
• A HEALTHCHECK, so a runner that waits for the container to become healthy will not race the first request.

⁠Tags

⁠License

Proprietary. The image is free to run for your own purposes or your organisation's, including in production and in automated test environments. Mirroring it into your own registry and building your own images on top of it are allowed. It may not be provided to others, by redistribution or by hosting it as a service, and may not be modified. It is provided as is, without warranty and without any obligation of support.

The full text is at spooler.sh/legal/memspoolerd-license.txt⁠ and at /LICENSE in the image.