tingz: stay deployin'
A secure, lightweight HTTP service for deploying static site artifacts with per-user directory isolation. Tested on Debian 12.
Quick Start
Production Deployment
Prerequisites:
- Go 1.25.3+
- Docker & Docker Compose
- Admin token (secure random string,
openssl rand -hex 16)
Create Restricted User
addgroup --system tingz # note gid, needed for 2nd command
adduser --ingroup tingz --system --no-create-home --uid ${GID} --shell /usr/sbin/nologin tingz
usermod -aG tingz caddy
Deploy
- Get source and checkout to a stable tag
git clone https://git.yigid.dev/fyb/tingz.git
cd tingz
git checkout v1.0
- Edit the environment variables
cp .env.example .env
vim .env
- Run with Docker
docker compose up --build -d
API Usage
See API.md.
License & Credits
GNU AGPL v3, by Yigid BALABAN.
Reach me at hey@yigid.dev.