[{"data":1,"prerenderedAt":477},["ShallowReactive",2],{"page-\u002Fget-started\u002Fcredentials":3,"surround-\u002Fget-started\u002Fcredentials":468},{"id":4,"title":5,"body":6,"description":460,"extension":461,"meta":462,"navigation":463,"path":464,"seo":465,"stem":466,"__hash__":467},"docs\u002Fget-started\u002Fcredentials.md","Credentials",{"type":7,"value":8,"toc":450},"minimark",[9,23,67,70,75,78,170,172,176,179,214,220,225,268,271,274,278,285,296,298,302,305,402,413,416,420,446],[10,11,12,13,22],"p",{},"This page shows how to add, use and remove SSH keys, API keys and registry credentials. You manage all three on the console's ",[14,15,21],"a",{"href":16,"rel":17,"target":20},"https:\u002F\u002Fconsole.cloud.featherless.ai\u002Fcredentials\u002Fssh-keys",[18,19],"noopener","noreferrer","_blank","Credentials page",".",[24,25,26,39],"table",{},[27,28,29],"thead",{},[30,31,32,36],"tr",{},[33,34,35],"th",{},"Credential",[33,37,38],{},"What it's for",[40,41,42,51,59],"tbody",{},[30,43,44,48],{},[45,46,47],"td",{},"SSH key",[45,49,50],{},"Connecting to instances with SSH.",[30,52,53,56],{},[45,54,55],{},"API key",[45,57,58],{},"Using the CLI.",[30,60,61,64],{},[45,62,63],{},"Registry credentials",[45,65,66],{},"Pulling private container images.",[68,69],"hr",{},[71,72,74],"h2",{"id":73},"add-an-ssh-key","Add an SSH key",[10,76,77],{},"SSH keys let you connect to running instances with your own SSH client. Each key belongs to you, and every instance in your organization accepts the keys of all its members.",[79,80,82,122],"tabs",{"sync":81},"interface",[83,84,86],"tabs-item",{"label":85},"Console",[87,88,89,102,108],"ol",{},[90,91,92,93,96,97,101],"li",{},"Open the ",[14,94,21],{"href":16,"rel":95,"target":20},[18,19]," and select the ",[98,99,100],"strong",{},"SSH keys"," tab.",[90,103,104,105,22],{},"Click ",[98,106,107],{},"Add key",[90,109,110,111,114,115,119,120,22],{},"Paste your public key into ",[98,112,113],{},"Public key",", for example the contents of ",[116,117,118],"code",{},"~\u002F.ssh\u002Fid_ed25519.pub",", and click ",[98,121,107],{},[83,123,125],{"label":124},"CLI",[126,127,132],"pre",{"className":128,"code":129,"language":130,"meta":131,"style":131},"language-bash shiki shiki-themes github-dark-default","featherless-cloud ssh-keys add\nfeatherless-cloud ssh-keys add ~\u002F.ssh\u002Fwork.pub --name work-laptop\n","bash","",[116,133,134,150],{"__ignoreMap":131},[135,136,139,143,147],"span",{"class":137,"line":138},"line",1,[135,140,142],{"class":141},"sQhOw","featherless-cloud",[135,144,146],{"class":145},"s9uIt"," ssh-keys",[135,148,149],{"class":145}," add\n",[135,151,153,155,157,160,163,167],{"class":137,"line":152},2,[135,154,142],{"class":141},[135,156,146],{"class":145},[135,158,159],{"class":145}," add",[135,161,162],{"class":145}," ~\u002F.ssh\u002Fwork.pub",[135,164,166],{"class":165},"sFSAA"," --name",[135,168,169],{"class":145}," work-laptop\n",[68,171],{},[71,173,175],{"id":174},"create-an-api-key","Create an API key",[10,177,178],{},"API keys let the CLI and your scripts act as you. You can create and revoke them only in the console.",[87,180,181,190,195,211],{},[90,182,92,183,96,187,101],{},[14,184,21],{"href":185,"rel":186,"target":20},"https:\u002F\u002Fconsole.cloud.featherless.ai\u002Fcredentials\u002Fapi-keys",[18,19],[98,188,189],{},"API keys",[90,191,104,192,22],{},[98,193,194],{},"Create key",[90,196,197,198,201,202,205,206,119,209,22],{},"Enter a ",[98,199,200],{},"Name",", choose ",[98,203,204],{},"Scopes"," and an expiry under ",[98,207,208],{},"Expires",[98,210,194],{},[90,212,213],{},"Copy the key.",[215,216,217],"warning",{},[10,218,219],{},"Featherless GPU Cloud doesn't store your API key, so save it somewhere secure, such as your password manager or a CI secret. Treat your API key like a password and don't share it with anyone.",[221,222,224],"h3",{"id":223},"choose-scopes","Choose scopes",[24,226,227,240],{},[27,228,229],{},[30,230,231,234,237],{},[33,232,233],{},"Scope",[33,235,236],{},"Read",[33,238,239],{},"Write",[40,241,242,255],{},[30,243,244,249,252],{},[45,245,246],{},[98,247,248],{},"Instances",[45,250,251],{},"View instances, Run Jobs, logs, metrics and network volumes.",[45,253,254],{},"Also create, change and delete them, and open terminals.",[30,256,257,262,265],{},[45,258,259],{},[98,260,261],{},"Account",[45,263,264],{},"View your profile, templates, SSH keys and registry credentials.",[45,266,267],{},"Also change them.",[10,269,270],{},"Write includes read. Give each script or person its own key with the narrowest scopes it needs, so you can revoke one without affecting the others.",[10,272,273],{},"A key acts in the organization that was active when you created it. To use another organization, switch to it in the console and create a key there.",[221,275,277],{"id":276},"revoke-a-key","Revoke a key",[10,279,280,281,284],{},"Open the key's actions menu, click ",[98,282,283],{},"Revoke key",", and confirm. Anything using the key stops working immediately.",[10,286,287,288,291,292,22],{},"Keys belonging to instances with the CLI installed are hidden unless you switch on ",[98,289,290],{},"Show instance keys",". They end when their instance stops. See ",[14,293,295],{"href":294},"\u002Finstances\u002Fcli-access","Use the CLI in an instance",[68,297],{},[71,299,301],{"id":300},"add-registry-credentials","Add registry credentials",[10,303,304],{},"Registry credentials let instances and Run Jobs pull private container images. They belong to the organization, and only owners and admins can add, change or remove them.",[79,306,307,350],{"sync":81},[83,308,309],{"label":85},[87,310,311,320,325,345],{},[90,312,92,313,96,317,101],{},[14,314,21],{"href":315,"rel":316,"target":20},"https:\u002F\u002Fconsole.cloud.featherless.ai\u002Fcredentials\u002Fregistries",[18,19],[98,318,319],{},"Registries",[90,321,104,322,22],{},[98,323,324],{},"Add credentials",[90,326,197,327,329,330,333,334,337,338,341,342,22],{},[98,328,200],{},", the ",[98,331,332],{},"Registry"," hostname (for example ",[116,335,336],{},"ghcr.io","), a ",[98,339,340],{},"Username",", and a ",[98,343,344],{},"Password or access token",[90,346,104,347,22],{},[98,348,349],{},"Save credentials",[83,351,352],{"label":124},[126,353,355],{"className":128,"code":354,"language":130,"meta":131,"style":131},"echo \"$GHCR_TOKEN\" | featherless-cloud registry-keys add ghcr --server ghcr.io --username my-user --password-stdin\n",[116,356,357],{"__ignoreMap":131},[135,358,359,362,365,369,372,376,379,382,384,387,390,393,396,399],{"class":137,"line":138},[135,360,361],{"class":165},"echo",[135,363,364],{"class":145}," \"",[135,366,368],{"class":367},"sZEs4","$GHCR_TOKEN",[135,370,371],{"class":145},"\"",[135,373,375],{"class":374},"suJrU"," |",[135,377,378],{"class":141}," featherless-cloud",[135,380,381],{"class":145}," registry-keys",[135,383,159],{"class":145},[135,385,386],{"class":145}," ghcr",[135,388,389],{"class":165}," --server",[135,391,392],{"class":145}," ghcr.io",[135,394,395],{"class":165}," --username",[135,397,398],{"class":145}," my-user",[135,400,401],{"class":165}," --password-stdin\n",[10,403,404,405,408,409,22],{},"Use an access token with read-only pull access where your registry supports it. When you deploy, ",[98,406,407],{},"Automatic"," picks a matching credential for the image's registry, or you can choose one. See ",[14,410,412],{"href":411},"\u002Ftemplates\u002Fcustom-images","Custom images",[10,414,415],{},"A credential that running instances use can't be deleted, and its registry can't be changed.",[71,417,419],{"id":418},"next-steps","Next steps",[421,422,423,432,440],"card-group",{},[424,425,429],"card",{"icon":426,"title":427,"to":428},"i-lucide-plug","Connect to an instance","\u002Finstances\u002Fconnect",[10,430,431],{},"Use your SSH key, the browser terminal or the CLI.",[424,433,437],{"icon":434,"title":435,"to":436},"i-lucide-terminal","Install the CLI","\u002Fcli",[10,438,439],{},"Sign in with an API key.",[424,441,443],{"icon":442,"title":412,"to":411},"i-lucide-container",[10,444,445],{},"Run your own image from a private registry.",[447,448,449],"style",{},"html pre.shiki code .sQhOw, html code.shiki .sQhOw{--shiki-default:#FFA657}html pre.shiki code .s9uIt, html code.shiki .s9uIt{--shiki-default:#A5D6FF}html pre.shiki code .sFSAA, html code.shiki .sFSAA{--shiki-default:#79C0FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sZEs4, html code.shiki .sZEs4{--shiki-default:#E6EDF3}html pre.shiki code .suJrU, html code.shiki .suJrU{--shiki-default:#FF7B72}",{"title":131,"searchDepth":152,"depth":152,"links":451},[452,453,458,459],{"id":73,"depth":152,"text":74},{"id":174,"depth":152,"text":175,"children":454},[455,457],{"id":223,"depth":456,"text":224},3,{"id":276,"depth":456,"text":277},{"id":300,"depth":152,"text":301},{"id":418,"depth":152,"text":419},"Connect securely to instances, automate with the CLI, and pull private images.","md",{},true,"\u002Fget-started\u002Fcredentials",{"title":5,"description":460},"get-started\u002Fcredentials","cVyaX3_6nsRmkb2Bc7PT4gYI1PidIB4vs42qsXBZg5g",[469,473],{"title":470,"path":471,"description":472},"Concepts","\u002Fget-started\u002Fconcepts","The building blocks of Featherless GPU Cloud and how they fit together.",{"title":474,"path":475,"description":476},"Instances overview","\u002Finstances","Develop, run notebooks, fine-tune and serve models on dedicated GPUs you control.",1794932598276]