Add your first host, connect, run a command and open SFTP in a few minutes.
Listen to this pageabout 2 min
This walkthrough uses a demo host. Replace demo, 127.0.0.1 and port 2222 with your own server. You need YourSSH installed and an SSH server you can sign in to.
1
Open the host editor
On the Hosts dashboard, click New host. The host editor opens on the right. Keep SSH selected at the top.
The host editor, empty.
2
Fill in the host
Enter a Label (a name you will recognize), the Hostname or IP, the port (default 22), your Username and Password. To use a key or your SSH agent instead, change Auth method. See Hosts for every option.
A filled-in host.
3
Test, then save
Click Test to check the address and credentials without opening a shell. A result such as Connected with a latency appears next to the button. Click Save. The host appears on the dashboard.
The saved host on the dashboard.
4
Connect
Double-click the host card to open a terminal tab (or open its three-dot menu and choose Connect). The first time you connect, YourSSH pins the server’s host key. See Host keys for what that means and when you get a warning.
Hover a card for quick actions: test, SFTP and the full menu.
5
Run a command
When the shell prompt appears, type a command and press Enter.
A connected terminal after running ls -la.
6
Open SFTP
Click the folder icon on the host card, or open the card’s menu and choose SFTP. The dual-panel file manager shows your computer on the left and the server on the right.
Dual-panel SFTP.
Next steps
Hosts
Groups, tags, keys, jump hosts and per-host options.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"YourSSH","description":"YourSSH is a fast, open-source SSH, SFTP, RDP and VNC client for macOS, Windows, Linux and Android.","colors":{"primary":"#E87C08","light":"#F3A231","dark":"#C76A06"},"logo":{"light":"https://mintcdn.com/your-ssh/hXl_1tpHLWW6nFrV/logo/light.svg?fit=max\u0026auto=format\u0026n=hXl_1tpHLWW6nFrV\u0026q=85\u0026s=af6f8821423df7db3617197a48b29757","dark":"https://mintcdn.com/your-ssh/hXl_1tpHLWW6nFrV/logo/dark.svg?fit=max\u0026auto=format\u0026n=hXl_1tpHLWW6nFrV\u0026q=85\u0026s=33ae26e05f50dbde0850947ac54a70a6","href":"https://github.com/YoursshLabs/yourssh"},"favicon":"https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/favicon.svg?fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=eacbd306aeb80a62ccd4aec8b3417480","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://github.com/YoursshLabs/yourssh/issues","label":"Issues"}],"primary":{"type":"button","label":"Download","href":"https://github.com/YoursshLabs/yourssh/releases/latest"}},"footer":{"socials":{"github":"https://github.com/YoursshLabs/yourssh"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/YoursshLabs/yourssh"},{"anchor":"Releases","icon":"download","href":"https://github.com/YoursshLabs/yourssh/releases"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"your-ssh","hasAudioNarration":true,"actualSubdomain":"your-ssh","customDomains":["yoursshlabs.com"],"gitSource":{"type":"github","owner":"yoursshlabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6af6c6629292933daccbd3f9"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af6e3a7af41c6763ee813eb","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"User guide","count":23},{"language":"default","tag":"Connections","count":6},{"language":"default","tag":"Developer guide","count":5},{"language":"default","tag":"Tools","count":5},{"language":"default","tag":"Develop","count":3},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Security","count":3},{"language":"default","tag":"Settings and sync","count":3},{"language":"default","tag":"Plugins","count":2},{"language":"default","tag":"Remote desktop","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"quickstart","slug":"/quickstart","pageMetadata":{"title":"Quickstart","description":"Add your first host, connect, run a command and open SFTP in a few minutes.","icon":"rocket","href":"/quickstart"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add your first host, connect, run a command and open SFTP in a few minutes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This walkthrough uses a demo host. Replace `,_jsx(_components.code,{children:`demo`}),`, `,_jsx(_components.code,{children:`127.0.0.1`}),` and port `,_jsx(_components.code,{children:`2222`}),` with your own server. You need `,_jsx(_components.a,{href:`/installation`,children:`YourSSH installed`}),` and an SSH server you can sign in to.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the host editor`,children:[_jsxs(_components.p,{children:[`On the `,_jsx(_components.strong,{children:`Hosts`}),` dashboard, click `,_jsx(_components.strong,{children:`New host`}),`. The host editor opens on the right. Keep `,_jsx(_components.strong,{children:`SSH`}),` selected at the top.`]}),_jsx(Frame,{caption:`The host editor, empty.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/01-new-host-panel.png?fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=30609928a44dddc97fb0a8d2bd5621c6`,alt:`The New Host panel with SSH, RDP and VNC tabs, general and credentials fields`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`868`,height:`868`,\"data-path\":`images/02-add-host/01-new-host-panel.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/01-new-host-panel.png?w=280\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=aa5754cebe048c7144d549012ccb03a7 280w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/01-new-host-panel.png?w=560\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=7b7ead0bb9ecce0e9274666455d2b317 560w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/01-new-host-panel.png?w=840\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=e931e61728f0fe2ed0eb32ff7bad0741 840w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/01-new-host-panel.png?w=1100\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=876b542a50d79a4fba944ed2f5fdb2a5 1100w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/01-new-host-panel.png?w=1650\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=4cab1e834f6897bc9a12938074fd3c69 1650w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/01-new-host-panel.png?w=2500\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=0168072f15a3121a79bf7f0ad52573a2 2500w`})})]}),_jsxs(Step,{title:`Fill in the host`,children:[_jsxs(_components.p,{children:[`Enter a `,_jsx(_components.strong,{children:`Label`}),` (a name you will recognize), the `,_jsx(_components.strong,{children:`Hostname or IP`}),`, the port (default `,_jsx(_components.code,{children:`22`}),`), your `,_jsx(_components.strong,{children:`Username`}),` and `,_jsx(_components.strong,{children:`Password`}),`. To use a key or your SSH agent instead, change `,_jsx(_components.strong,{children:`Auth method`}),`. See `,_jsx(_components.a,{href:`/user-guide/hosts`,children:`Hosts`}),` for every option.`]}),_jsx(Frame,{caption:`A filled-in host.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/09-filled-form.png?fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=9b600ffc88eb5174ad5dd1740623439f`,alt:`The host editor filled with the label Demo Server, host 127.0.0.1, port 2222 and user demo`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`868`,height:`868`,\"data-path\":`images/02-add-host/09-filled-form.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/09-filled-form.png?w=280\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=0cee59ba09ebf70486f5f697d44fe0b8 280w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/09-filled-form.png?w=560\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=ff9bcb4e2b02370c1256de941083dfed 560w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/09-filled-form.png?w=840\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=89468cb67d039201581fa4e0b2502205 840w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/09-filled-form.png?w=1100\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=132a43c3925d69daa01e0bd710fcd6e0 1100w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/09-filled-form.png?w=1650\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=eaecf3fcaa4edf74568e1b2f85ff1d38 1650w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/09-filled-form.png?w=2500\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=d5ae9045f0dd92e800d2a80079b41fb6 2500w`})})]}),_jsxs(Step,{title:`Test, then save`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Test`}),` to check the address and credentials without opening a shell. A result such as `,_jsx(_components.strong,{children:`Connected`}),` with a latency appears next to the button. Click `,_jsx(_components.strong,{children:`Save`}),`. The host appears on the dashboard.`]}),_jsx(Frame,{caption:`The saved host on the dashboard.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/11-dashboard-with-host.png?fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=c12edc1bae38470814feb75e9ffa4d40`,alt:`The hosts dashboard with the new Demo Server card inside the DEMO group`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`868`,height:`868`,\"data-path\":`images/02-add-host/11-dashboard-with-host.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/11-dashboard-with-host.png?w=280\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=78b7bae5032f33adb97e4320bbf25179 280w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/11-dashboard-with-host.png?w=560\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=4038b5a466d5ceaf720229e897c18572 560w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/11-dashboard-with-host.png?w=840\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=8a35ff414fe7d3c6b740d55483389c02 840w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/11-dashboard-with-host.png?w=1100\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=3ab6ef953f1fb846de895572a935122e 1100w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/11-dashboard-with-host.png?w=1650\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=482fcf3b38f35ed4ef8e92d1ee0ac7ef 1650w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/02-add-host/11-dashboard-with-host.png?w=2500\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=dec4db5503a9a2dfc7c22b70689cf963 2500w`})})]}),_jsxs(Step,{title:`Connect`,children:[_jsxs(_components.p,{children:[`Double-click the host card to open a terminal tab (or open its three-dot menu and choose `,_jsx(_components.strong,{children:`Connect`}),`). The first time you connect, YourSSH pins the server’s host key. See `,_jsx(_components.a,{href:`/user-guide/host-keys`,children:`Host keys`}),` for what that means and when you get a warning.`]}),_jsx(Frame,{caption:`Hover a card for quick actions: test, SFTP and the full menu.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/02-card-hover-actions.png?fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=4baf5fc5c30bed0878bc1241d9d4e037`,alt:`A host card with the test, SFTP and more-actions buttons visible on hover`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`868`,height:`868`,\"data-path\":`images/03-first-connect/02-card-hover-actions.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/02-card-hover-actions.png?w=280\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=9c937ad93d90fc96d58f30e75683b4ef 280w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/02-card-hover-actions.png?w=560\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=188a178205f29473897119d9182947c7 560w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/02-card-hover-actions.png?w=840\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=73fe8051a7734670aa1d814856b5354b 840w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/02-card-hover-actions.png?w=1100\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=8086a3041c311f0057cde928cfc3be36 1100w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/02-card-hover-actions.png?w=1650\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=32d092e16c60e990bc3ee72544bd8d9c 1650w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/02-card-hover-actions.png?w=2500\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=32a3f56cbc053ad33b112b248b10f234 2500w`})})]}),_jsxs(Step,{title:`Run a command`,children:[_jsx(_components.p,{children:`When the shell prompt appears, type a command and press Enter.`}),_jsx(Frame,{caption:`A connected terminal after running ls -la.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/07-terminal-ls.png?fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=ebc9e2fc17d3067c87e42d306192ccd6`,alt:`A terminal tab connected to Demo Server, showing the output of ls -la`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`868`,height:`868`,\"data-path\":`images/03-first-connect/07-terminal-ls.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/07-terminal-ls.png?w=280\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=8e0b84ebf9e4b58fe19df7070dc69104 280w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/07-terminal-ls.png?w=560\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=e66a6717207fbfe16620d81252b2af18 560w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/07-terminal-ls.png?w=840\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=c1f1e67052284e6f56abc621e5439af9 840w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/07-terminal-ls.png?w=1100\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=44ec65cf2bfddaa11452c75a4afc3f9d 1100w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/07-terminal-ls.png?w=1650\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=f7229f0e614555c67784692764d756ac 1650w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/03-first-connect/07-terminal-ls.png?w=2500\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=d989514a288d308587b26ccddd6a188a 2500w`})})]}),_jsxs(Step,{title:`Open SFTP`,children:[_jsxs(_components.p,{children:[`Click the folder icon on the host card, or open the card’s menu and choose `,_jsx(_components.strong,{children:`SFTP`}),`. The dual-panel file manager shows your computer on the left and the server on the right.`]}),_jsx(Frame,{caption:`Dual-panel SFTP.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/07-sftp/03-dual-panel.png?fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=31e047899a76c10adb02ef97c2b7875a`,alt:`The SFTP screen with the local home folder on the left and the remote home folder on the right`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`868`,height:`868`,\"data-path\":`images/07-sftp/03-dual-panel.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/07-sftp/03-dual-panel.png?w=280\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=88a745ddd42c8be86c0d6449a2c6554f 280w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/07-sftp/03-dual-panel.png?w=560\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=6f14d2c1d77afd1f047f81f2e96d27da 560w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/07-sftp/03-dual-panel.png?w=840\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=d34a4808f8ddaebf92ebaa053a55a2f7 840w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/07-sftp/03-dual-panel.png?w=1100\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=fd421d7b5ddb080be97c582e5f57fd66 1100w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/07-sftp/03-dual-panel.png?w=1650\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=9948d5f41e4a342377c7f8d75a97b09d 1650w, https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/07-sftp/03-dual-panel.png?w=2500\u0026fit=max\u0026auto=format\u0026n=vNM8XA5Zlrh1XSOb\u0026q=85\u0026s=ef89170191f1bdc27bd25d3651985417 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Hosts`,icon:`server`,href:`/user-guide/hosts`,children:_jsx(_components.p,{children:`Groups, tags, keys, jump hosts and per-host options.`})}),_jsx(Card,{title:`Terminal`,icon:`square-terminal`,href:`/user-guide/terminal`,children:_jsx(_components.p,{children:`Tabs, split view, search and hotkeys.`})}),_jsx(Card,{title:`SFTP`,icon:`folder-open`,href:`/user-guide/sftp`,children:_jsx(_components.p,{children:`Transfer files in both directions.`})}),_jsx(Card,{title:`Keychain`,icon:`key-round`,href:`/user-guide/keychain`,children:_jsx(_components.p,{children:`Generate an SSH key and deploy it to a host.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Quickstart","description":"Add your first host, connect, run a command and open SFTP in a few minutes.","icon":"rocket","href":"/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"narration":{"path":"quickstart","locale":"en","estimatedDurationSec":108},"subdomain":"your-ssh","siteName":"YourSSH","title":"Quickstart - YourSSH","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T08:55:04.944Z","originalFileLocation":"quickstart.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add your first host, connect, run a command and open SFTP in a few minutes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"YourSSH\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Quickstart - YourSSH\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add your first host, connect, run a command and open SFTP in a few minutes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"YourSSH\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://yoursshlabs.com/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://your-ssh.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Quickstart\u0026amp;description=Add+your+first+host%2C+connect%2C+run+a+command+and+open+SFTP+in+a+few+minutes.\u0026amp;theme=65790bf5e932daf838158150\u0026amp;signature=8b125c6dde55f6a939c8cba872fcbb21d23c134d61c03bb44e04e71d707c0141\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Quickstart - YourSSH\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add your first host, connect, run a command and open SFTP in a few minutes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://your-ssh.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Quickstart\u0026amp;description=Add+your+first+host%2C+connect%2C+run+a+command+and+open+SFTP+in+a+few+minutes.\u0026amp;theme=65790bf5e932daf838158150\u0026amp;signature=8b125c6dde55f6a939c8cba872fcbb21d23c134d61c03bb44e04e71d707c0141\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/your-ssh/nmAMNuFtrlVCA3bb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"YourSSH\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E87C08\">\u003clink data-mint-head rel=\"canonical\" href=\"https://yoursshlabs.com/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/quickstart.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://yoursshlabs.com/#organization\",\"name\":\"YourSSH\",\"url\":\"https://yoursshlabs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/your-ssh/hXl_1tpHLWW6nFrV/logo/light.svg?fit=max\u0026auto=format\u0026n=hXl_1tpHLWW6nFrV\u0026q=85\u0026s=af6f8821423df7db3617197a48b29757\"}},{\"@type\":\"WebSite\",\"@id\":\"https://yoursshlabs.com#website\",\"name\":\"YourSSH\",\"url\":\"https://yoursshlabs.com\",\"publisher\":{\"@id\":\"https://yoursshlabs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://yoursshlabs.com/quickstart#webpage\",\"url\":\"https://yoursshlabs.com/quickstart\",\"name\":\"Quickstart\",\"description\":\"Add your first host, connect, run a command and open SFTP in a few minutes.\",\"dateModified\":\"2026-11-13T08:55:04.944Z\",\"isPartOf\":{\"@id\":\"https://yoursshlabs.com#website\"},\"breadcrumb\":{\"@id\":\"https://yoursshlabs.com/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://yoursshlabs.com/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://yoursshlabs.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Quickstart\",\"item\":\"https://yoursshlabs.com/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://yoursshlabs.com/quickstart#article\",\"headline\":\"Quickstart\",\"name\":\"Quickstart\",\"description\":\"Add your first host, connect, run a command and open SFTP in a few minutes.\",\"url\":\"https://yoursshlabs.com/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://yoursshlabs.com/quickstart#webpage\"},\"dateModified\":\"2026-11-13T08:55:04.944Z\",\"publisher\":{\"@id\":\"https://yoursshlabs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://yoursshlabs.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"YourSSH\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"YourSSH\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/quickstart.md","siteName":"YourSSH","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/YoursshLabs/yourssh"},{"anchor":"Releases","icon":"download","href":"https://github.com/YoursshLabs/yourssh/releases"}]},"tabs":[{"tab":"User guide","groups":[{"group":"Get started","pages":[{"title":"Introduction","icon":"terminal","href":""},{"title":"Installation","description":"Download and install YourSSH on macOS, Windows, Linux or Android.","icon":"download","href":"/installation"},{"title":"Quickstart","icon":"rocket","href":"/quickstart"}]},{"group":"Connections","pages":[{"title":"Hosts","description":"Organize saved SSH, RDP and VNC hosts on the dashboard and configure each one in the host editor.","icon":"server","href":"/user-guide/hosts"},{"title":"Host keys","icon":"shield-check","href":"/user-guide/host-keys"},{"title":"Terminal","icon":"terminal","href":"/user-guide/terminal"},{"title":"Terminal sharing","icon":"screen-share","href":"/user-guide/terminal-sharing"},{"title":"Bulk actions","icon":"layers","href":"/user-guide/bulk-actions"},{"title":"Port forwarding","icon":"arrow-left-right","href":"/user-guide/port-forwarding"}]},{"group":"Files","pages":[{"title":"SFTP","icon":"folder","href":"/user-guide/sftp"}]},{"group":"Remote desktop","pages":[{"title":"RDP remote desktop","icon":"monitor","href":"/user-guide/rdp"},{"title":"VNC remote desktop","icon":"cast","href":"/user-guide/vnc"}]},{"group":"Security","pages":[{"title":"Keychain and credentials","icon":"key","href":"/user-guide/keychain"},{"title":"Session recording","icon":"video","href":"/user-guide/recording"},{"title":"Audit log","icon":"scroll-text","href":"/user-guide/audit-log"}]},{"group":"Tools","pages":[{"title":"Snippets","icon":"code","href":"/user-guide/snippets"},{"title":"AI assistant","icon":"bot","href":"/user-guide/ai-chat"},{"title":"DevOps Hub","icon":"rocket","href":"/user-guide/devops"},{"title":"Web tools","icon":"wrench","href":"/user-guide/web-tools"},{"title":"Command line and links","icon":"square-terminal","href":"/user-guide/cli"}]},{"group":"Settings and sync","pages":[{"title":"Settings","icon":"settings","href":"/user-guide/settings"},{"title":"Sync and device transfer","icon":"refresh-cw","href":"/user-guide/sync"},{"title":"YourSSH for Android","icon":"smartphone","href":"/user-guide/mobile"}]}]},{"tab":"Developer guide","pages":[{"title":"Developer guide","href":"/developer-guide/architecture"}]},{"tab":"Release notes","pages":[{"title":"Release notes","href":"/release-notes"}]}]},"basePath":"","title":"Quickstart - YourSSH","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["2bfc744e19","07c022d89b","a74be98ba7"],"chunks":["NarrationPlayer-D9E2DBwD.js","shallow-BA55zJxQ.js","Frame-1H5zLJUq.js","DynamicMarkdown-RhjEuCHC.js","zoom-image-lightbox-CkI5al_8.js","lightbox-handle-r17bVUz3.js"]}