{"_id":"5a8fae0368264c001f20cc0a","category":{"_id":"5a8fae0268264c001f20cc01","version":"5a8fae0268264c001f20cc00","project":"5633ebff7e9e880d00af1a53","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-30T22:34:26.440Z","from_sync":false,"order":0,"slug":"early-project-setup","title":"Bonsai.io Basics"},"parentDoc":null,"user":"5633eb67737ea01700ea328b","project":"5633ebff7e9e880d00af1a53","version":{"_id":"5a8fae0268264c001f20cc00","project":"5633ebff7e9e880d00af1a53","__v":4,"createdAt":"2018-02-23T06:00:34.961Z","releaseDate":"2018-02-23T06:00:34.961Z","categories":["5a8fae0268264c001f20cc01","5a8fae0268264c001f20cc02","5a8fae0368264c001f20cc03","5a8fae0368264c001f20cc04","5a8fae0368264c001f20cc05","5a8fae0368264c001f20cc06","5a8fae0368264c001f20cc07","5a8fae0368264c001f20cc08","5a8fae0368264c001f20cc09","5abaa7eb72d6dc0028a07bf3","5b8ee7842790f8000333f9ba","5b8ee8f244a21a00034b5cd9"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2.0"},"githubsync":"","__v":0,"updates":["56a86505c48ee00d0092e146","56c5e0434c3c320d00c3fc7b","58e387ad7bd1620f002c8bef"],"next":{"pages":[],"description":""},"createdAt":"2015-11-02T20:59:00.878Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Creating an account on Bonsai is the first step towards provisioning and scaling an Elasticsearch cluster on demand. Use the following guide to get started.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Hold Up!\",\n  \"body\": \"Bonsai clusters can be provisioned in a couple of different ways. These instructions are for users who want to be billed directly by Bonsai. If you are a Heroku or Manifold customer and are adding Bonsai to your app, then you will not need these instructions. Instead, check out:\\n\\n* [Getting Started With Heroku](doc:getting-started-with-heroku) \\n* [Getting Started With Manifold](doc:getting-started-with-manifold)\"\n}\n[/block]\n## Sign up at bonsai.io/signup\n\nNavigate to the [sign up page](https://app.bonsai.io/signup), where you'll provide an email address:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/56d30e6-Screen_Shot_2018-02-23_at_12.03.15_AM.png\",\n        \"Screen Shot 2018-02-23 at 12.03.15 AM.png\",\n        1070,\n        842,\n        \"#0d4d73\"\n      ],\n      \"caption\": \"Add your email address to launch a free cluster.\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Email Validation\",\n  \"body\": \"We validate emails using [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) and [RFC 3696](https://www.ietf.org/rfc/rfc3696.txt). If you have a non-conforming email address, let us know at [support:::at:::bonsai.io](mailto:support@bonsai.io).\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ad16a03-Screen_Shot_2018-02-23_at_12.04.36_AM.png\",\n        \"Screen Shot 2018-02-23 at 12.04.36 AM.png\",\n        1034,\n        620,\n        \"#0d4b71\"\n      ],\n      \"caption\": \"If your email address is accepted, we'll send a confirmation link.\"\n    }\n  ]\n}\n[/block]\nIf everything is good, you should receive an email from us shortly with a confirmation link.\n\n## Confirm your email\n\nNavigate to your email client. You should receive the following email from our system:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2c7d052-Screen_Shot_2018-02-23_at_12.11.13_AM.png\",\n        \"Screen Shot 2018-02-23 at 12.11.13 AM.png\",\n        1266,\n        952,\n        \"#ebebeb\"\n      ],\n      \"caption\": \"Example confirmation email.\"\n    }\n  ]\n}\n[/block]\nClick on the button, which will take you to a form to complete your sign up.\n\n## Complete your account details\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Haven't We Seen You Before?\",\n  \"body\": \"If you have signed up for Bonsai in the past using this email address, you will receive an email directing you to log in using it.\"\n}\n[/block]\nAfter clicking on the `Confirm email` button from the confirmation email, you will be presented with a simple form to complete your account.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/85e312d-Screen_Shot_2018-02-23_at_12.15.49_AM.png\",\n        \"Screen Shot 2018-02-23 at 12.15.49 AM.png\",\n        1086,\n        1286,\n        \"#3c627b\"\n      ],\n      \"caption\": \"The sign up form is quick and painless.\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Protip: Use a strong password\",\n  \"body\": \"We're a security-conscious bunch, but we don't have any arcane rules about what kinds of characters you must use for your password. Why? We'll let [xkcd explain it](https://xkcd.com/936/), but the tl;dr is our password policy simply enforces a minimum length of 10 characters. We also reject common passwords that [have been pwned](https://haveibeenpwned.com/Passwords). Sadly, `correct horse battery staple` appears in our blacklist.\\n\\nWe also highly recommend using a password manager like [1Password](https://1password.com/) to generate unique, secure passwords.\"\n}\n[/block]\nOnce your account has been created, you'll be able to [create your first cluster](doc:creating-your-first-cluster) . Note that you can provision a free starter cluster without entering payment details. If you wish to provision a larger cluster with more resources, you can click on the link to [add a credit card](https://app.bonsai.io/account/billing) to your account.\n\nYou can also modify your account at any time. Check out [Managing Your Account](doc:managing-your-account) for information about:\n\n* Updating your profile\n* Changing your password\n* Inviting team members\n* Updating billing\n* Adding coupon codes\n* ... and more!","excerpt":"Sign up to create a free Elasticsearch cluster.","slug":"getting-started-with-bonsaiio","type":"basic","title":"Getting Started With Bonsai.io"}

Getting Started With Bonsai.io

Sign up to create a free Elasticsearch cluster.

Creating an account on Bonsai is the first step towards provisioning and scaling an Elasticsearch cluster on demand. Use the following guide to get started. [block:callout] { "type": "warning", "title": "Hold Up!", "body": "Bonsai clusters can be provisioned in a couple of different ways. These instructions are for users who want to be billed directly by Bonsai. If you are a Heroku or Manifold customer and are adding Bonsai to your app, then you will not need these instructions. Instead, check out:\n\n* [Getting Started With Heroku](doc:getting-started-with-heroku) \n* [Getting Started With Manifold](doc:getting-started-with-manifold)" } [/block] ## Sign up at bonsai.io/signup Navigate to the [sign up page](https://app.bonsai.io/signup), where you'll provide an email address: [block:image] { "images": [ { "image": [ "https://files.readme.io/56d30e6-Screen_Shot_2018-02-23_at_12.03.15_AM.png", "Screen Shot 2018-02-23 at 12.03.15 AM.png", 1070, 842, "#0d4d73" ], "caption": "Add your email address to launch a free cluster." } ] } [/block] [block:callout] { "type": "info", "title": "Email Validation", "body": "We validate emails using [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) and [RFC 3696](https://www.ietf.org/rfc/rfc3696.txt). If you have a non-conforming email address, let us know at [support@bonsai.io](mailto:support@bonsai.io)." } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/ad16a03-Screen_Shot_2018-02-23_at_12.04.36_AM.png", "Screen Shot 2018-02-23 at 12.04.36 AM.png", 1034, 620, "#0d4b71" ], "caption": "If your email address is accepted, we'll send a confirmation link." } ] } [/block] If everything is good, you should receive an email from us shortly with a confirmation link. ## Confirm your email Navigate to your email client. You should receive the following email from our system: [block:image] { "images": [ { "image": [ "https://files.readme.io/2c7d052-Screen_Shot_2018-02-23_at_12.11.13_AM.png", "Screen Shot 2018-02-23 at 12.11.13 AM.png", 1266, 952, "#ebebeb" ], "caption": "Example confirmation email." } ] } [/block] Click on the button, which will take you to a form to complete your sign up. ## Complete your account details [block:callout] { "type": "warning", "title": "Haven't We Seen You Before?", "body": "If you have signed up for Bonsai in the past using this email address, you will receive an email directing you to log in using it." } [/block] After clicking on the `Confirm email` button from the confirmation email, you will be presented with a simple form to complete your account. [block:image] { "images": [ { "image": [ "https://files.readme.io/85e312d-Screen_Shot_2018-02-23_at_12.15.49_AM.png", "Screen Shot 2018-02-23 at 12.15.49 AM.png", 1086, 1286, "#3c627b" ], "caption": "The sign up form is quick and painless." } ] } [/block] [block:callout] { "type": "info", "title": "Protip: Use a strong password", "body": "We're a security-conscious bunch, but we don't have any arcane rules about what kinds of characters you must use for your password. Why? We'll let [xkcd explain it](https://xkcd.com/936/), but the tl;dr is our password policy simply enforces a minimum length of 10 characters. We also reject common passwords that [have been pwned](https://haveibeenpwned.com/Passwords). Sadly, `correct horse battery staple` appears in our blacklist.\n\nWe also highly recommend using a password manager like [1Password](https://1password.com/) to generate unique, secure passwords." } [/block] Once your account has been created, you'll be able to [create your first cluster](doc:creating-your-first-cluster) . Note that you can provision a free starter cluster without entering payment details. If you wish to provision a larger cluster with more resources, you can click on the link to [add a credit card](https://app.bonsai.io/account/billing) to your account. You can also modify your account at any time. Check out [Managing Your Account](doc:managing-your-account) for information about: * Updating your profile * Changing your password * Inviting team members * Updating billing * Adding coupon codes * ... and more!