Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

EU Digital COVID Certificate: Overview

Where can I find ...Architectural OverviewAbout this ProjectCreditsHow to ContributeLicensing

Where can I find ...

This repository provides an overview over the EU Digital COVID Certificate (DGC) project, and acts as a central storage for various useful documents related to the project. The table below acts as navigation aid to find the information you are looking for.

Topic Link Description
General Discussion Discussion General discussion and questions regarding Digital Green Certificates.
Slack Slack Workspace Invite, DGC Channel The Linux Foundation Public Health Slack channel for developer discussions.
Member State Onboarding dgc-participating-countries Relevant information for participating countries.
Guides guides General guides related to DGC.
API Tests dgc-api-tests Automated API test cases for DGCG.
Test Specifications test-specifications Contains specification for acceptance test on gateway-API and DGCA-E2E Tests.
Specification hcert-spec Specification developed by the eHealth Network Interoperability Subgroup.
EU eHealth Network Further information and specifications regarding DGC.
Source Code DGC Github Organisation Profile A list of all other repositories, especially for the component source codes.
DCC Debugging DCC Credential Debugger The prefixed version of the base45 can be added to read the content of a DCC
DCC Debugging CBOR Debugger The Binary Content of the COSE Payload can be debugged in this tool.
DCC Debugging DCC Info QR-Code scanner with DCC decoder

Architectural Overview

Architectural Overview

Supported Certificate Types

The current verifier and wallet apps are supporting for verification and storing:

Other formats are prepared but not yet implemented. For establishing the trustlist, the verifier service shares a list of trusted issuer links, downloaded from the gateway Verifier Service

Reference Document: Verifiable Credentials

About this Project

The digital green certificate implements the EU trustframework according the specification of the eHealth Network Interoperability Subgroup (

To this end the European Commission has tasked Deutsche Telekom and SAP to develop the Digital Green Certificates Gateway as well as template applications that may be used by all countries connected to the gateway. These include a national backend with an issuer component ( Issuance Service, Issuance Web ) and an app to validate Digital Green Certificates ( Verifier Service, Verifier App - Android, Verifier App - iOS ) as well as a wallet app to be used by the citizens of connected countries ( Wallet App - Android, Wallet App - iOS ).

Further information can be found at

A note on using the apps and released APK files found in this GitHub organization: The apps are reference implementations that cannot be used in production environments as-is, but rather need to be configured by EU member states to access their national backends. The released APK files are configured to work with the test environments and will not report correct results on "live" DCCs.


We'd like to thank all the partners who have been involved in this project from the beginning. Special mention is due to the eHealth Network Interoperability Subgroup that creates the specification for this project.

How to contribute

Contribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines. By participating in this project, you agree to abide by its Code of Conduct at all times.


Copyright (C) 2021 T-Systems International GmbH and all other contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the LICENSE for the specific language governing permissions and limitations under the License.


This repository provides an overview over the EU Digital Green Certificates (DGC) project.



Code of conduct

Security policy





No releases published