Warning: Quay requires docker version 0.6.2 or higher to work

User Guide

Pulling a repository from Quay

Note: Private repositories require you to be logged in or the pull will fail. See below for how to sign into Quay if you have never done so before.
To pull a repository from Quay, run the following command: 

docker pull quay.io/username/repo_name

Pushing a repository to Quay Requires Write Access

First, tag the image with your repository name:

docker tag 0u123imageid quay.io/username/repo_name

Second, push the repository to Quay:

docker push quay.io/username/repo_name

Granting and managing permissions to users Requires Admin Access

Quay allows a repository to be shared any number of users and to grant those users any level of permissions for a repository
  • Permissions for a repository can be granted and managed in the repository's admin interface
  • Adding a user: Type that user's username in the "Add New User..." field, and select the user
  • Changing permissions: A user's permissions (read, read/write or admin) can be changed by clicking the field to the right of the user
  • Removing a user: A user can be removed from the list by clicking the X and then clicking Delete

Using access tokens in place of users Requires Admin Access

There are many circumstances where it makes sense to not use a user's username and password (deployment scripts, etc). To support this case, Quay allows the use of access tokens which can be created on a repository and have read and/or write permissions, without any passwords.
  • Tokens can be managed in the repository's admin interface
  • Adding a token: Enter a user-readable description in the "New token description" field
  • Changing permissions: A token's permissions (read or read/write) can be changed by clicking the field to the right of the token
  • Deleting a token: A token can be deleted by clicking the X and then clicking Delete
  • Using a token: To use the token, the following credentials can be used:
    Username
    $token
    Password
    (token value can be found by clicking on the token)
    Email
    This value is ignored, any value may be used.

Signing into Quay Optional

If you have never pushed a repository to Quay and wish to pull a private repository, you can sign into Quay by running the following command: 

docker login quay.io