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