raphaeljaeger/printtag-web repository overview

⁠PrintTag Web

PrintTag Web is a self-hosted web application for working with NFC tags through your browser.

⁠Features

• Self-hosted and easy to deploy with Docker
• Persistent data storage using a Docker volume
• HTTPS support for browser features that require a secure context, such as Web NFC
• HTTP support for deployment behind a reverse proxy
• Compatible with reverse proxy solutions such as Nginx Proxy Manager
• Automatic container restart after failures or system reboots

⁠Quick Start

Create a docker-compose.yml file:

services:
  printtag-web:
    image: raphaeljaeger/printtag-web:latest
    container_name: printtag-web
    restart: unless-stopped
    ports:
      - "8443:8443"
      - "8081:8080"
    volumes:
      - printtag-data:/data

volumes:
  printtag-data:

Start the container:

docker compose up -d

⁠Access

• HTTPS: https://localhost:8443⁠
• HTTP: http://localhost:8081⁠

Replace localhost with your server's IP address or hostname when accessing the application remotely.

⁠HTTPS

The built-in HTTPS endpoint uses a self-signed certificate. Your browser may display a certificate warning.

HTTPS is required for browser features such as Web NFC, which are only available in secure contexts. Browsers generally treat localhost as a secure context, but remote access requires a trusted HTTPS setup.

⁠Reverse Proxy

The HTTP endpoint on port 8081 can be used behind a reverse proxy such as Nginx Proxy Manager.

Configure your reverse proxy to forward requests to:

• Scheme: HTTP
• Forward Hostname / IP: Your Docker host or container address
• Forward Port: 8081 (if the published port is used)

Enable HTTPS on the reverse proxy and configure a valid TLS certificate for your domain.

Note that browser features such as Web NFC still require the client to access the application through a secure context.

⁠Persistent Data

The Docker volume printtag-data is mounted at /data to preserve application data across container restarts and image updates.

⁠Updating

Pull the latest image and recreate the container:

docker compose pull
docker compose up -d

⁠Docker Image

raphaeljaeger/printtag-web:latest