{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Manage Docker repositories","type":"basic","slug":"manage-docker-repositories","excerpt":"","body":"##Overview\n\nManage your [Docker](doc:docker-basics) repositories by specifying privacy settings and designating specific levels of access for each member of your repository. A repository (or \"repo\") is a container which holds multiple revisions of a docker image.\n\nFurthermore, each revision is called a \"tag\" and every image is described by the repository name and a tag, e.g. <repository>:<tag>.\n\n##Create a repository\n\n1. Click on **Developer** in the main menu bar and choose **Docker registry**.\n2. Click **Create repository**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5ff5583-create-new-repository.png\",\n        \"create-new-repository.png\",\n        595,\n        421,\n        \"#f8f7f5\"\n      ]\n    }\n  ]\n}\n[/block]\n\n3. Enter the name of your repository. Repository name must be at least 3 characters long and can only contain lowercase letters, numbers, ., - and _.\n4. Choose if your repository will be private or public (see below).\n5. Click **Create**.\n\nYour repository is now created. The next step [pushing an image](doc:upload-your-docker-image-1#section-push-your-image) to your repository.\n\nAlternatively you can create a repository by pushing an image from your local machine to the Seven Bridges Docker registry. The visibility of the repository will be set to private by default.\n\n## Adjust privacy settings\n\n1. Click on **Developer** in the main menu bar and choose **Docker registry**.\n2. Click the cog icon <img src=\"https://files.readme.io/d5f2092-cog.png\"\nheight=\"12px\" width=\"auto\" align=\"inline\" style=\"margin:1px\"/> next to the desired repository. You can now see repository settings.\n3. In the **Privacy** section adjust your repository's privacy settings (see below for details about each of the privacy settings):\n    * If your repository is currently a public repository, you will see the **Make private** button. Clicking this button will make the repository private.\n    * If your repository is currently a private repository, you will see the **Make public** button. Clicking this button will make the repository public.\n\nWhat each of the repository privacy settings means:\n  * **Public** - Anyone can pull images from your repository, but only users who are added as members and are given write permissions can push images to your repository.\n  * **Private** - The repository can only be accessed by its members. Members who have read permissions are only able to pull images, while those with **write** permissions can also push to the repository.\n\n##Manage member access\n\nManage access to your repositories by adding members and setting their permissions.\n\n###Access the Manage members tab\n\n1. Click on **Developer** in the main menu bar and choose **Docker registry**.\n2. Click the members icon . The following window is displayed.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/394488f-manage-members.jpg\",\n        \"manage-members.jpg\",\n        980,\n        285,\n        \"#f0f3f2\"\n      ]\n    }\n  ]\n}\n[/block]\n ###Add a member\n\n1. In the section labeled Invite new members, type the member's username. Note that only existing Platform users who are members of the project in which the repository is used can be added as members of your repository. \n2. Set the member's permissions in the adjacent dropdown menu:\n  * **read** - the member will be allowed to view the contents of the repository\n  * **copy** - the member will be allowed to pull images from the repository\n  * **write** - the member will be allowed to push images to the repository\n  * **admin** - the member will be allowed to do all of the above, but will also be allowed to delete a repo and images as well as manage repository privacy settings.\n\nAfter adding a member to a repository, also make sure they are a member of the project the repository will be used in.\n \n###Change a member's permissions\n\n1. Open the permissions menu next to a member's username.\n2. Check or uncheck the desired member's permissions for the repository.\n\n###Remove a member from your repository\n\n1. Click the **X** icon next to the member you want to remove.\n2. Click **Remove** on the confirmation dialog, and that member will be removed from your repository.\n\n##Delete an image\n\nBefore deleting an image, please make sure it is not required by other tools and workflows.\n\n1. Click on **Developer** in the main menu bar and choose **Docker registry**.\n2. Click the the desired repository.\n3. Click the delete icon next to the desired image.\n4. Click **Delete** to confirm.\n\n##Leave a repository\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You cannot leave a repository you own.\"\n}\n[/block]\n1. Click on **Developer** in the main menu bar and choose **Docker registry**.\n2. Click the cog icon next to the desired repository.\n3. Click the leave icon next to the desired repository in the **Actions** column.\n4. Click **Leave** to confirm leaving the repository.\n\n##Delete a repository\n\nThe option for deleting a repository is only available to owners and administrators. In addition, when you delete a repository all accompanying images will be deleted as well. All related tools and workflows will no longer work. This action is irreversible.\n\n1. Click on **Developer** in the main menu bar and choose **Docker registry**.\n2. Click the cog icon next to the desired repository.\n3. Click **Delete**.\n4. Click **Delete** once again to confirm your action and the repository will be deleted.\n\n##Delete an image\nThe option for deleting an image is only available to owners and administrators. When you delete an image, all related tools and workflows will no longer work. This action is irreversible.\n\n1. Click on **Developer** in the main menu bar and choose **Docker registry**.\n2. Click name of the repository that contains the image you want to delete.\n3. Click the image name.\n4. Click **Delete**.\n5. Click **Delete** once again to confirm your action and the image will be deleted.","updates":[],"order":23,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"59d37fa96f3e26002818aaad","project":"5773dcfc255e820e00e1cd4d","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5773dcfc255e820e00e1cd51","5773df36904b0c0e00ef05ff","577baf92451b1e0e006075ac","577bb183b7ee4a0e007c4e8d","577ce77a1cf3cb0e0048e5ea","577d11865fd4de0e00cc3dab","578e62792c3c790e00937597","578f4fd98335ca0e006d5c84","578f5e5c3d04570e00976ebb","57bc35f7531e000e0075d118","57f801b3760f3a1700219ebb","5804d55d1642890f00803623","581c8d55c0dc651900aa9350","589dcf8ba8c63b3b00c3704f","594cebadd8a2f7001b0b53b2","59a562f46a5d8c00238e309a","5a2aa096e25025003c582b58","5a2e79566c771d003ca0acd4","5a3a5166142db90026f24007","5a3a52b5bcc254001c4bf152","5a3a574a2be213002675c6d2","5a3a66bb2be213002675cb73","5a3a6e4854faf60030b63159","5c8a68278e883901341de571","5cb9971e57bf020024523c7b","5cbf1683e2a36d01d5012ecd","5dc15666a4f788004c5fd7d7"],"_id":"5773dcfc255e820e00e1cd50","__v":27,"createdAt":"2016-06-29T14:36:44.812Z","releaseDate":"2016-06-29T14:36:44.812Z","project":"5773dcfc255e820e00e1cd4d"},"category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Developer tools","slug":"developer-hub","order":6,"from_sync":false,"reference":false,"_id":"577baf92451b1e0e006075ac","__v":0,"createdAt":"2016-07-05T13:01:06.540Z","project":"5773dcfc255e820e00e1cd4d","version":"5773dcfc255e820e00e1cd50"},"user":"566590c83889610d0008a253","createdAt":"2017-10-03T12:16:41.695Z","githubsync":"","__v":0,"parentDoc":null}

Manage Docker repositories


##Overview Manage your [Docker](doc:docker-basics) repositories by specifying privacy settings and designating specific levels of access for each member of your repository. A repository (or "repo") is a container which holds multiple revisions of a docker image. Furthermore, each revision is called a "tag" and every image is described by the repository name and a tag, e.g. <repository>:<tag>. ##Create a repository 1. Click on **Developer** in the main menu bar and choose **Docker registry**. 2. Click **Create repository**. [block:image] { "images": [ { "image": [ "https://files.readme.io/5ff5583-create-new-repository.png", "create-new-repository.png", 595, 421, "#f8f7f5" ] } ] } [/block] 3. Enter the name of your repository. Repository name must be at least 3 characters long and can only contain lowercase letters, numbers, ., - and _. 4. Choose if your repository will be private or public (see below). 5. Click **Create**. Your repository is now created. The next step [pushing an image](doc:upload-your-docker-image-1#section-push-your-image) to your repository. Alternatively you can create a repository by pushing an image from your local machine to the Seven Bridges Docker registry. The visibility of the repository will be set to private by default. ## Adjust privacy settings 1. Click on **Developer** in the main menu bar and choose **Docker registry**. 2. Click the cog icon <img src="https://files.readme.io/d5f2092-cog.png" height="12px" width="auto" align="inline" style="margin:1px"/> next to the desired repository. You can now see repository settings. 3. In the **Privacy** section adjust your repository's privacy settings (see below for details about each of the privacy settings): * If your repository is currently a public repository, you will see the **Make private** button. Clicking this button will make the repository private. * If your repository is currently a private repository, you will see the **Make public** button. Clicking this button will make the repository public. What each of the repository privacy settings means: * **Public** - Anyone can pull images from your repository, but only users who are added as members and are given write permissions can push images to your repository. * **Private** - The repository can only be accessed by its members. Members who have read permissions are only able to pull images, while those with **write** permissions can also push to the repository. ##Manage member access Manage access to your repositories by adding members and setting their permissions. ###Access the Manage members tab 1. Click on **Developer** in the main menu bar and choose **Docker registry**. 2. Click the members icon . The following window is displayed. [block:image] { "images": [ { "image": [ "https://files.readme.io/394488f-manage-members.jpg", "manage-members.jpg", 980, 285, "#f0f3f2" ] } ] } [/block] ###Add a member 1. In the section labeled Invite new members, type the member's username. Note that only existing Platform users who are members of the project in which the repository is used can be added as members of your repository. 2. Set the member's permissions in the adjacent dropdown menu: * **read** - the member will be allowed to view the contents of the repository * **copy** - the member will be allowed to pull images from the repository * **write** - the member will be allowed to push images to the repository * **admin** - the member will be allowed to do all of the above, but will also be allowed to delete a repo and images as well as manage repository privacy settings. After adding a member to a repository, also make sure they are a member of the project the repository will be used in. ###Change a member's permissions 1. Open the permissions menu next to a member's username. 2. Check or uncheck the desired member's permissions for the repository. ###Remove a member from your repository 1. Click the **X** icon next to the member you want to remove. 2. Click **Remove** on the confirmation dialog, and that member will be removed from your repository. ##Delete an image Before deleting an image, please make sure it is not required by other tools and workflows. 1. Click on **Developer** in the main menu bar and choose **Docker registry**. 2. Click the the desired repository. 3. Click the delete icon next to the desired image. 4. Click **Delete** to confirm. ##Leave a repository [block:callout] { "type": "info", "body": "You cannot leave a repository you own." } [/block] 1. Click on **Developer** in the main menu bar and choose **Docker registry**. 2. Click the cog icon next to the desired repository. 3. Click the leave icon next to the desired repository in the **Actions** column. 4. Click **Leave** to confirm leaving the repository. ##Delete a repository The option for deleting a repository is only available to owners and administrators. In addition, when you delete a repository all accompanying images will be deleted as well. All related tools and workflows will no longer work. This action is irreversible. 1. Click on **Developer** in the main menu bar and choose **Docker registry**. 2. Click the cog icon next to the desired repository. 3. Click **Delete**. 4. Click **Delete** once again to confirm your action and the repository will be deleted. ##Delete an image The option for deleting an image is only available to owners and administrators. When you delete an image, all related tools and workflows will no longer work. This action is irreversible. 1. Click on **Developer** in the main menu bar and choose **Docker registry**. 2. Click name of the repository that contains the image you want to delete. 3. Click the image name. 4. Click **Delete**. 5. Click **Delete** once again to confirm your action and the image will be deleted.