11notes

docker-tinyauth: Run Tinyauth Rootless and Distroless

A rootless, distroless Docker image for Tinyauth, the authentication middleware from tinyauthapp. It adds login or OAuth protection to Docker apps behind proxies such as Traefik, Nginx, and Caddy, with amd64 and arm64 support.

ActiveDockerfileMITDockerSelf HostedSecurity
View on GitHub Compare
Stars
103
Forks
7
Stars, last 30 days
+0
Last commit
today
Contributors
2

Our take

Activeregular commits and releases

Health score

34/100

How it is scored
Activity
56
Community
40
Issues
21
Pull requests
20

+0 stars in the last 30 days

  • Fewer contributors than 86% of the projects we track

This is a focused, actively maintained Docker packaging of Tinyauth, with security-oriented runtime defaults and a small contributor base.

Good fit if

  • You already use Tinyauth and want a rootless, distroless image for Docker deployments.
  • You run Traefik, Nginx, or Caddy and need authentication middleware for proxied apps.
  • You can follow the project’s versioned tags and manage the persistent /tinyauth/var volume.

Look elsewhere if

  • You need an authentication product other than Tinyauth or do not want to operate it behind a supported proxy.
  • Your environment requires a shell inside the container for troubleshooting or administration.
  • You need evidence of a broader contributor base or recent issue and pull-request resolution: the measured activity is concentrated among two contributors, with no issues closed or pull requests merged in the recent period.
All health signals
Last commit2026-11-16 (today)
Commits, last 90 days11
Releases, last 12 months9 (latest v3.2.1, 2026-11-16)
Contributors2 (top contributor: 51% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age16 months

Checked on 2026-11-17 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

103

Forks

7

Change since Nov 16, 2026: 0 stars·0 forks

Overview

This repository packages Tinyauth, the authentication middleware created by tinyauthapp, as a rootless and distroless Docker image. Tinyauth adds a login screen or OAuth authentication to Docker apps behind proxies including Traefik, Nginx, and Caddy. The image targets amd64 and arm64.

The project is for operators who want Tinyauth’s proxy authentication features with a small, security-focused container image. It runs as UID/GID 1000 by default, has no shell, and is designed to run read-only.

Key Features

  • Packages Tinyauth as a rootless image running as UID/GID 1000 by default.
  • Uses a distroless base built from scratch, without a shell.
  • Supports amd64 and arm64 architectures.
  • Includes a health check and is designed for read-only container operation.
  • Provides a persistent /tinyauth/var volume for the SQLite database and static assets.
  • Supports versioned image tags and publishes to Docker Hub, GHCR, and Quay.
  • The README says images are automatically updated and scanned for CVEs before and after publishing.

Use Cases

  • A self-hosting operator wants to add a login gate to apps routed through Traefik.
  • A team running Nginx or Caddy wants to use Tinyauth as authentication middleware for internal services.
  • A Docker administrator wants an authentication service packaged to run without root privileges and with a read-only filesystem.
  • An operator needs persistent storage for Tinyauth’s SQLite database and static assets while keeping the container image itself immutable.

What you need

Detected in the repository

  • Dockerfile (main language on GitHub)
  • A Compose file to run it with its related services
  • Automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Prepare a Compose file with your Tinyauth app URL, authentication users, proxy configuration, and a persistent /tinyauth/var volume. Then start the service:

docker compose up -d

See the README for the full Compose example, configuration details, and tag guidance. The example includes a default account, so replace it with your own credentials.

Alternatives

  • authelia: Authelia is a full authentication server with SSO, access rules, and second-factor options, while docker-tinyauth packages Tinyauth as a lightweight proxy middleware.
ProjectLanguageLicenseStarsStatus
docker-tinyauthDockerfileMIT103Active
autheliaGoApache-2.029.2kActive

Considerations

The image is a Docker packaging of Tinyauth rather than a standalone authentication implementation. The README’s example uses Traefik and includes a socket proxy, so deployments need suitable proxy and Docker networking configuration. The container’s no-shell, distroless design can make interactive troubleshooting less convenient. The measured project activity is active, with regular commits and releases, but most contributions come from one person; recent issue and pull-request closure activity is absent. The repository reports CI but no tests, so teams that require a test suite should assess that against their own adoption criteria.

Found this useful?

Share it with someone who would like docker-tinyauth.

Comparisons