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 user a user's username and password (deployment scripts, etc). To support this case, Quay allows the user 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)

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