|
| 1 | +--- |
| 2 | +title:"Create a Codefresh account" |
| 3 | +description:"Welcome to Codefresh!" |
| 4 | +group:getting-started |
| 5 | +redirect_from: |
| 6 | + -/docs/ |
| 7 | + -/docs/create-an-account/ |
| 8 | + -/docs/getting-started/ |
| 9 | + -/docs/getting-started/introduction/ |
| 10 | +--- |
| 11 | +Before you can do anything in Codefresh such as building and deploying your applications, you need to create a Codefresh account. |
| 12 | + |
| 13 | +Creating an account in Codefresh is free (no credit card is required) and can be done in three simple steps |
| 14 | + |
| 15 | +{% include |
| 16 | +image.html |
| 17 | +lightbox="true" |
| 18 | +file="/images/getting-started/create-account/create-account-steps.png" |
| 19 | +url="/images/getting-started/create-account/create-account-steps.png" |
| 20 | +alt="Codefresh account creation steps" |
| 21 | +max-width="90%" |
| 22 | +%} |
| 23 | + |
| 24 | +##Step 1: Select your Identity Provider |
| 25 | +As the first step in setting up ypur account in Codefresh, select the identity provider (IdP) to use. |
| 26 | +Codefresh currently supports the following IdPs: |
| 27 | +GitHub |
| 28 | +Bitbucket |
| 29 | +GitLab |
| 30 | +Azure |
| 31 | +Google |
| 32 | +LDAP |
| 33 | + |
| 34 | +If you need an IdP that is not in the list, please[contact us](https://codefresh.io/contact-us/) with the details. |
| 35 | + |
| 36 | +>NOTES: |
| 37 | + For Git repositories, the login method is less important, as you can Git repositories through[Git integrations]({{site.baseurl}}/docs/integrations/git-providers/), regardless of your sign-up process. |
| 38 | + |
| 39 | + If you multiple sign-up methods, as long as you use the same email address in all the sign-ups, Codefresh automatically redirects you to the account dashboard. |
| 40 | + |
| 41 | +1. Go to the[Codefresh Sign Up page](https://g.codefresh.io/signup).<!---need to change the URL and the screenshot--> |
| 42 | + |
| 43 | + |
| 44 | +{% include |
| 45 | +image.html |
| 46 | +lightbox="true" |
| 47 | +file="/images/getting-started/create-account/select-identity-provider.png" |
| 48 | +url="/images/getting-started/create-account/select-identity-provider.png" |
| 49 | +alt="Codefresh sign-up page" |
| 50 | +caption="Sign-up page (click image to enlarge)" |
| 51 | +max-width="40%" |
| 52 | +%} |
| 53 | + |
| 54 | +1. Select the IdP for sign-up. |
| 55 | +1. Continue |
| 56 | + |
| 57 | + |
| 58 | + |
| 59 | +##Step 2: Accept the permissions request |
| 60 | + |
| 61 | +After you select the IdP (identity provider), Codefresh requests permission to access your basic details, and for Git providers, to access your Git repositories). The Permissions window that is displayed differs according to the IdP selected in the previous step. |
| 62 | + |
| 63 | +Don't worry, Codefresh will not do anything without your explicit approval, so don't be scared by the permissions shown |
| 64 | +in the request window. The permissions requested by Codefresh are needed in order to build and deploy your projects. |
| 65 | + |
| 66 | +1. Click |
| 67 | + |
| 68 | +* For GitHub: To continue, click**Authorize codefresh-io**. |
| 69 | + |
| 70 | +{% include |
| 71 | +image.html |
| 72 | +lightbox="true" |
| 73 | +file="/images/getting-started/create-account/github-authorize.png" |
| 74 | +url="/images/getting-started/create-account/github-authorize.png" |
| 75 | +alt="GitHub authorization page" |
| 76 | +caption="GitHub authorization page (click image to enlarge)" |
| 77 | +max-width="50%" |
| 78 | +%} |
| 79 | + |
| 80 | +* For Bitbucket: To continue, click**Grant access**. |
| 81 | + |
| 82 | + |
| 83 | +{% include |
| 84 | +image.html |
| 85 | +lightbox="true" |
| 86 | +file="/images/getting-started/create-account/bitbucket-authorize.png" |
| 87 | +url="/images/getting-started/create-account/bitbucket-authorize.png" |
| 88 | +alt="Bitbucket authorization page" |
| 89 | +caption="Bitbucket authorization page (click image to enlarge)" |
| 90 | +max-width="50%" |
| 91 | +%} |
| 92 | + |
| 93 | +* For GitLab: To continue, click**Authorize**. |
| 94 | + |
| 95 | + |
| 96 | +{% include |
| 97 | +image.html |
| 98 | +lightbox="true" |
| 99 | +file="/images/getting-started/create-account/gitlab-authorize.png" |
| 100 | +url="/images/getting-started/create-account/gitlab-authorize.png" |
| 101 | +alt="GitLab authorization page" |
| 102 | +caption="GitLab authorization page (click image to enlarge)" |
| 103 | +max-width="50%" |
| 104 | +%} |
| 105 | + |
| 106 | +Once you confirm the permissions for your Git provider, Codefresh automatically connects to your Git provider and fetches your basic account details, such as your email. |
| 107 | + |
| 108 | + |
| 109 | +##Step 3: Verify account details |
| 110 | + |
| 111 | +Verifying account details is the final step in creating your Codefresh account. |
| 112 | + |
| 113 | +1. Review the details for your new account, make the relevant changes, and click**NEXT**. |
| 114 | + |
| 115 | +{% include |
| 116 | +image.html |
| 117 | +lightbox="true" |
| 118 | +file="/images/getting-started/create-account/codefresh-signup.png" |
| 119 | +url="/images/getting-started/create-account/codefresh-signup.png" |
| 120 | +alt="Codefresh account details" |
| 121 | +caption="Codefresh account details (click image to enlarge)" |
| 122 | +max-width="40%" |
| 123 | +%} |
| 124 | + |
| 125 | +{:start="2"} |
| 126 | +1. Enter a name for your account, and click**NEXT**. |
| 127 | + |
| 128 | +{% include |
| 129 | +image.html |
| 130 | +lightbox="true" |
| 131 | +file="/images/getting-started/create-account/codefresh-accountname.png" |
| 132 | +url="/images/getting-started/create-account/codefresh-accountname.png" |
| 133 | +alt="Codefresh account name" |
| 134 | +caption="Codefresh account name (click image to enlarge)" |
| 135 | +max-width="40%" |
| 136 | +%} |
| 137 | + |
| 138 | +{:start="3"} |
| 139 | +1. Finally, answer the questions to personalize your account and click**FINISH**. |
| 140 | + |
| 141 | +{% include |
| 142 | +image.html |
| 143 | +lightbox="true" |
| 144 | +file="/images/getting-started/create-account/codefresh-personalize.png" |
| 145 | +url="/images/getting-started/create-account/codefresh-personalize.png" |
| 146 | +alt="Codefresh personalize account" |
| 147 | +caption="Codefresh personalize account (click image to enlarge)" |
| 148 | +max-width="40%" |
| 149 | +%} |
| 150 | + |
| 151 | +Congratulations! Your new Codefresh account is now ready. |
| 152 | + |
| 153 | +{% include |
| 154 | +image.html |
| 155 | +lightbox="true" |
| 156 | +file="/images/getting-started/create-account/codefresh-dashboard.png" |
| 157 | +url="/images/getting-started/create-account/codefresh-dashboard.png" |
| 158 | +alt="Codefresh dashboard" |
| 159 | +caption="Codefresh dashboard (click image to enlarge)" |
| 160 | +max-width="40%" |
| 161 | +%} |
| 162 | + |
| 163 | + |
| 164 | + |
| 165 | +<!---nned to verify |
| 166 | +The next step is learning how to [build your first application]({{site.baseurl}}/docs/getting-started/create-a-basic-pipeline/). |
| 167 | +
|
| 168 | +
|
| 169 | +## Other Git connection options |
| 170 | +
|
| 171 | +
|
| 172 | +
|
| 173 | +Codefresh also supports Atlassian Stash/Bitbucket Server. You need to [contact us](https://codefresh.io/contact-us/) to enable this integration before you can use it for your account. |
| 174 | +
|
| 175 | +
|
| 176 | +{% include |
| 177 | +image.html |
| 178 | +lightbox="true" |
| 179 | +file="/images/getting-started/create-account/stash.png" |
| 180 | +url="/images/getting-started/create-account/stash.png" |
| 181 | +alt="Codefresh and Atlassian Stash" |
| 182 | +caption="Codefresh and Atlassian Stash" |
| 183 | +max-width="100%" |
| 184 | +%} |
| 185 | +
|
| 186 | +
|
| 187 | +Once that is done, follow the [Stash instructions]({{site.baseurl}}/docs/integrations/git-providers/#atlassian-stash) for more information. |
| 188 | +
|
| 189 | +
|
| 190 | +
|
| 191 | +## Using Codefresh in a secure corporate environment |
| 192 | +
|
| 193 | +If your source code repositories are in a private Git account that lies behind your company firewall, or simply has no access to the Internet, we can still help you! |
| 194 | +
|
| 195 | +{% include |
| 196 | +image.html |
| 197 | +lightbox="true" |
| 198 | +file="/images/getting-started/create-account/git-firewall.png" |
| 199 | +url="/images/getting-started/create-account/git-firewall.png" |
| 200 | +alt="Git behind firewall" |
| 201 | +caption="Git behind firewall" |
| 202 | +max-width="100%" |
| 203 | +%} |
| 204 | +
|
| 205 | +We can establish a VPN / tunnel to your network or discuss options for an on-premises Codefresh deployment. Please [contact us to get started](https://codefresh.io/contact-us/). |
| 206 | +
|
| 207 | +--> |
| 208 | +##What to read next |
| 209 | + |
| 210 | +*[Create a Basic pipeline]({{site.baseurl}}/docs/getting-started/create-a-basic-pipeline/) |
| 211 | +*[Deploy to Kubernetes]({{site.baseurl}}/docs/getting-started/deployment-to-kubernetes-quick-start-guide/) |
| 212 | +*[Introduction to Codefresh pipelines]({{site.baseurl}}/docs/configure-ci-cd-pipeline/introduction-to-codefresh-pipelines/) |
| 213 | +*[Pipeline examples]({{site.baseurl}}/docs/yaml-examples/examples/) |
| 214 | + |
| 215 | + |