{"__v":1,"_id":"57ad3c523f00b90e00b7c8f4","category":{"__v":0,"_id":"5721e9c849df4f0e00528321","project":"5656d449a795770d00a2aec1","version":"5721e9c849df4f0e0052831f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-11-26T14:07:50.747Z","from_sync":false,"order":0,"slug":"introduction","title":"SAFE Launcher"},"parentDoc":null,"project":"5656d449a795770d00a2aec1","user":"54ad4a56f6f5b10b0066dc86","version":{"__v":1,"_id":"5721e9c849df4f0e0052831f","hasDoc":true,"hasReference":true,"project":"5656d449a795770d00a2aec1","createdAt":"2016-04-28T10:45:28.369Z","releaseDate":"2016-04-28T10:45:28.369Z","categories":["5721e9c849df4f0e00528320","5721e9c849df4f0e00528321","5721e9c849df4f0e00528322","5721e9c849df4f0e00528323","5721e9c849df4f0e00528324","5721e9c849df4f0e00528325","5721e9c849df4f0e00528326","5721e9c849df4f0e00528327","5721e9c849df4f0e00528328","5721e9c849df4f0e00528329"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"0.5.0","version":"0.5"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-12T03:02:42.054Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Limitations\",\n  \"body\": \"This alpha release has some technical limitations (see the [Limitations](https://maidsafe.readme.io/docs/install-launcher#limitations) section on the previous page).\"\n}\n[/block]\nSAFE Launcher will act as your gateway to the SAFE Network. You can use it to connect to the SAFE Network, to authorise apps to connect on your behalf and to access websites that are hosted on the SAFE Network.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/46ae64c-Screen_Shot_2016-08-11_at_11.19.00_PM.png\",\n        \"Screen Shot 2016-08-11 at 11.19.00 PM.png\",\n        1500,\n        1100,\n        \"#eaebeb\"\n      ]\n    }\n  ]\n}\n[/block]\n**Why do we need a gateway?**\n\nSAFE Launcher enables you to use [SAFE Network apps](https://apps.safenetwork.org/) without giving them access to your network credentials (your account secret and your account password). This means you only have to share your network credentials with SAFE Launcher and not with every application you use. Apps only interact with the SAFE Network indirectly via SAFE Launcher, which can be thought of as the single point of contact with the network.\n\n**What will SAFE Launcher do for you?**\n\n* SAFE Launcher will allow you to create an account on the SAFE Network and to access it from any computer where SAFE Launcher is installed.\n\n* SAFE Launcher will ask you to manually authorise apps that want to access the SAFE Network on your behalf.\n\n* SAFE Launcher will create a dedicated directory for every app that you authorise. Apps are only able to store data in their own directory, they can't access the directory of other apps.\n\n* SAFE Launcher will create a special directory known as the SAFE Drive directory. You can use it to store documents, images, audio files, videos...etc.... This directory can be used to share data between multiple apps. For example, a camera app can store images in SAFE Drive and another image editing application can read the images from SAFE Drive. To access SAFE Drive, apps need to ask for the \"SAFE Drive Access\" permission.\n\n* SAFE Launcher will let you access SAFE Network websites in most web browsers (via the `.safenet` domain extension). You just need to make sure that you've [configured the proxy](doc:proxy-setup).\n\n* SAFE Launcher will make it easy for you to revoke access to any app that had been previously authorised to access the SAFE Network on your behalf.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Go to the [Install SAFE Launcher](doc:install-launcher) page.\",\n  \"title\": \"If you haven't installed SAFE Launcher yet\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Proxy Settings\"\n}\n[/block]\nThe first time you open Launcher, you will see this screen:\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0faafbe-Screen_Shot_2016-08-01_at_12.21.17_AM.png\",\n        \"Screen Shot 2016-08-01 at 12.21.17 AM.png\",\n        1500,\n        1100,\n        \"#e9e9e9\"\n      ]\n    }\n  ]\n}\n[/block]\nAs explained in the image above, the proxy server allows you to view websites and content from the SAFE Network in the browser of your choice. It's enabled by default, but you can choose to disable it.\n\nTo configure this proxy, go to [Proxy Setup](doc:proxy-setup) page.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"You can browse the SAFE Network without creating an account.\",\n  \"body\": \"Unregistered users are able to browse `.safenet` websites (no need to create an account or login). As long as you've [configured the proxy](doc:proxy-setup), you should be able to access any public website hosted on the SAFE Network.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Create an Account\"\n}\n[/block]\nAfter the **Proxy Settings** screen, you'll see a tutorial that will walk you through the steps for creating an account.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/ef53bbb-Screen_Shot_2016-08-01_at_12.44.36_AM.png\",\n        \"Screen Shot 2016-08-01 at 12.44.36 AM.png\",\n        1500,\n        1100,\n        \"#5494d4\"\n      ]\n    }\n  ]\n}\n[/block]\nAs explained in the text below, accounts are made of two parts: an **account secret** and an **account password**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/2124ddb-Screen_Shot_2016-08-01_at_12.48.27_AM.png\",\n        \"Screen Shot 2016-08-01 at 12.48.27 AM.png\",\n        1500,\n        1100,\n        \"#5594d4\"\n      ]\n    }\n  ]\n}\n[/block]\nThe first information you'll need to enter is your **account secret**, which is used to locate your account information on the network.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c0cd121-Screen_Shot_2016-08-01_at_12.48.37_AM.png\",\n        \"Screen Shot 2016-08-01 at 12.48.37 AM.png\",\n        1500,\n        1100,\n        \"#5494d4\"\n      ]\n    }\n  ]\n}\n[/block]\nThe second information you'll need to enter is your **account password**, which is used to unlock and access all of your data.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/55f652e-Screen_Shot_2016-08-01_at_1.02.54_AM.png\",\n        \"Screen Shot 2016-08-01 at 1.02.54 AM.png\",\n        1500,\n        1100,\n        \"#5695d4\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5609219-Screen_Shot_2016-08-01_at_1.02.59_AM.png\",\n        \"Screen Shot 2016-08-01 at 1.02.59 AM.png\",\n        1500,\n        1100,\n        \"#5494d4\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Successful registration\",\n  \"body\": \"Once registration is complete you will see the screen below. This means you are now logged in and connected to the SAFE Network via Launcher.\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/799c38f-Screen_Shot_2016-08-11_at_10.59.25_PM.png\",\n        \"Screen Shot 2016-08-11 at 10.59.25 PM.png\",\n        1500,\n        1100,\n        \"#ebebeb\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Account\"\n}\n[/block]\nThe **Account** tab lets you manage permissions from [compatible apps](https://apps.safenetwork.org/) that you have allowed access.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4142908-Screen_Shot_2016-08-11_at_11.17.17_PM.png\",\n        \"Screen Shot 2016-08-11 at 11.17.17 PM.png\",\n        1500,\n        1100,\n        \"#eaebeb\"\n      ]\n    }\n  ]\n}\n[/block]\nIf you click on one of the apps in your list of authorised apps, you will the permissions and the logs for that app.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/44c698c-Screen_Shot_2016-08-11_at_11.17.20_PM.png\",\n        \"Screen Shot 2016-08-11 at 11.17.20 PM.png\",\n        1500,\n        1100,\n        \"#ddf0ea\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Dashboard\"\n}\n[/block]\nThe **Dashboard** tab lets you view statistics about your activity on the SAFE Network.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a4136ac-Screen_Shot_2016-08-01_at_1.48.44_AM.png\",\n        \"Screen Shot 2016-08-01 at 1.48.44 AM.png\",\n        1500,\n        1100,\n        \"#e5e5e6\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Request Types\",\n    \"0-0\": \"PUT\",\n    \"1-0\": \"GET\",\n    \"2-0\": \"POST\",\n    \"3-0\": \"DELETE\",\n    \"0-1\": \"Store new data on the network.\",\n    \"1-1\": \"Retrieve data from the network.\",\n    \"2-1\": \"Modify data on the network.\",\n    \"3-1\": \"Delete data from the network.\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Logs\"\n}\n[/block]\nThe logs show you what your applications are doing. If you experience a bug or an issue, the logs might help you understand what the problem is.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/90cd1af-Screen_Shot_2016-08-12_at_8.55.32_AM.png\",\n        \"Screen Shot 2016-08-12 at 8.55.32 AM.png\",\n        1500,\n        1100,\n        \"#def0ea\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Settings\"\n}\n[/block]\nTo access **.safenet** websites, make sure that the **Proxy Server** is enabled (it should be by default) and that you've followed the [Proxy Setup guide](doc:proxy-setup).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5ab91dd-Screen_Shot_2016-08-01_at_1.17.44_AM.png\",\n        \"Screen Shot 2016-08-01 at 1.17.44 AM.png\",\n        1500,\n        1100,\n        \"#ebebeb\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"Setup an Automatic Proxy to browse the SAFE Network.\",\n  \"body\": \"[Guide to setup a proxy on your machine](doc:proxy-setup)\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Help\"\n}\n[/block]\nIf you need help with anything related to SAFE Launcher or SAFE Demo App, the best place to ask for help is the [SAFE Network Forum](https://safenetforum.org). Please use the [#support](https://forum.safenetwork.io/c/support) category when creating a new topic.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/93a23e9-Screen_Shot_2016-08-11_at_11.01.54_PM.png\",\n        \"Screen Shot 2016-08-11 at 11.01.54 PM.png\",\n        1500,\n        1100,\n        \"#dcdbdc\"\n      ]\n    }\n  ]\n}\n[/block]\n**Where should I report issues?**\n\nTo report issues and/or bugs with SAFE Launcher, please [open an issue on GitHub](https://github.com/maidsafe/safe_launcher/issues). You will need to have a GitHub account (they are free) to raise an issue.","excerpt":"","slug":"launcher","type":"basic","title":"Using SAFE Launcher"}

Using SAFE Launcher


[block:callout] { "type": "warning", "title": "Limitations", "body": "This alpha release has some technical limitations (see the [Limitations](https://maidsafe.readme.io/docs/install-launcher#limitations) section on the previous page)." } [/block] SAFE Launcher will act as your gateway to the SAFE Network. You can use it to connect to the SAFE Network, to authorise apps to connect on your behalf and to access websites that are hosted on the SAFE Network. [block:image] { "images": [ { "image": [ "https://files.readme.io/46ae64c-Screen_Shot_2016-08-11_at_11.19.00_PM.png", "Screen Shot 2016-08-11 at 11.19.00 PM.png", 1500, 1100, "#eaebeb" ] } ] } [/block] **Why do we need a gateway?** SAFE Launcher enables you to use [SAFE Network apps](https://apps.safenetwork.org/) without giving them access to your network credentials (your account secret and your account password). This means you only have to share your network credentials with SAFE Launcher and not with every application you use. Apps only interact with the SAFE Network indirectly via SAFE Launcher, which can be thought of as the single point of contact with the network. **What will SAFE Launcher do for you?** * SAFE Launcher will allow you to create an account on the SAFE Network and to access it from any computer where SAFE Launcher is installed. * SAFE Launcher will ask you to manually authorise apps that want to access the SAFE Network on your behalf. * SAFE Launcher will create a dedicated directory for every app that you authorise. Apps are only able to store data in their own directory, they can't access the directory of other apps. * SAFE Launcher will create a special directory known as the SAFE Drive directory. You can use it to store documents, images, audio files, videos...etc.... This directory can be used to share data between multiple apps. For example, a camera app can store images in SAFE Drive and another image editing application can read the images from SAFE Drive. To access SAFE Drive, apps need to ask for the "SAFE Drive Access" permission. * SAFE Launcher will let you access SAFE Network websites in most web browsers (via the `.safenet` domain extension). You just need to make sure that you've [configured the proxy](doc:proxy-setup). * SAFE Launcher will make it easy for you to revoke access to any app that had been previously authorised to access the SAFE Network on your behalf. [block:callout] { "type": "info", "body": "Go to the [Install SAFE Launcher](doc:install-launcher) page.", "title": "If you haven't installed SAFE Launcher yet" } [/block] [block:api-header] { "type": "basic", "title": "Proxy Settings" } [/block] The first time you open Launcher, you will see this screen: [block:image] { "images": [ { "image": [ "https://files.readme.io/0faafbe-Screen_Shot_2016-08-01_at_12.21.17_AM.png", "Screen Shot 2016-08-01 at 12.21.17 AM.png", 1500, 1100, "#e9e9e9" ] } ] } [/block] As explained in the image above, the proxy server allows you to view websites and content from the SAFE Network in the browser of your choice. It's enabled by default, but you can choose to disable it. To configure this proxy, go to [Proxy Setup](doc:proxy-setup) page. [block:callout] { "type": "info", "title": "You can browse the SAFE Network without creating an account.", "body": "Unregistered users are able to browse `.safenet` websites (no need to create an account or login). As long as you've [configured the proxy](doc:proxy-setup), you should be able to access any public website hosted on the SAFE Network." } [/block] [block:api-header] { "type": "basic", "title": "Create an Account" } [/block] After the **Proxy Settings** screen, you'll see a tutorial that will walk you through the steps for creating an account. [block:image] { "images": [ { "image": [ "https://files.readme.io/ef53bbb-Screen_Shot_2016-08-01_at_12.44.36_AM.png", "Screen Shot 2016-08-01 at 12.44.36 AM.png", 1500, 1100, "#5494d4" ] } ] } [/block] As explained in the text below, accounts are made of two parts: an **account secret** and an **account password**. [block:image] { "images": [ { "image": [ "https://files.readme.io/2124ddb-Screen_Shot_2016-08-01_at_12.48.27_AM.png", "Screen Shot 2016-08-01 at 12.48.27 AM.png", 1500, 1100, "#5594d4" ] } ] } [/block] The first information you'll need to enter is your **account secret**, which is used to locate your account information on the network. [block:image] { "images": [ { "image": [ "https://files.readme.io/c0cd121-Screen_Shot_2016-08-01_at_12.48.37_AM.png", "Screen Shot 2016-08-01 at 12.48.37 AM.png", 1500, 1100, "#5494d4" ] } ] } [/block] The second information you'll need to enter is your **account password**, which is used to unlock and access all of your data. [block:image] { "images": [ { "image": [ "https://files.readme.io/55f652e-Screen_Shot_2016-08-01_at_1.02.54_AM.png", "Screen Shot 2016-08-01 at 1.02.54 AM.png", 1500, 1100, "#5695d4" ] } ] } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/5609219-Screen_Shot_2016-08-01_at_1.02.59_AM.png", "Screen Shot 2016-08-01 at 1.02.59 AM.png", 1500, 1100, "#5494d4" ] } ] } [/block] [block:callout] { "type": "success", "title": "Successful registration", "body": "Once registration is complete you will see the screen below. This means you are now logged in and connected to the SAFE Network via Launcher." } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/799c38f-Screen_Shot_2016-08-11_at_10.59.25_PM.png", "Screen Shot 2016-08-11 at 10.59.25 PM.png", 1500, 1100, "#ebebeb" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Account" } [/block] The **Account** tab lets you manage permissions from [compatible apps](https://apps.safenetwork.org/) that you have allowed access. [block:image] { "images": [ { "image": [ "https://files.readme.io/4142908-Screen_Shot_2016-08-11_at_11.17.17_PM.png", "Screen Shot 2016-08-11 at 11.17.17 PM.png", 1500, 1100, "#eaebeb" ] } ] } [/block] If you click on one of the apps in your list of authorised apps, you will the permissions and the logs for that app. [block:image] { "images": [ { "image": [ "https://files.readme.io/44c698c-Screen_Shot_2016-08-11_at_11.17.20_PM.png", "Screen Shot 2016-08-11 at 11.17.20 PM.png", 1500, 1100, "#ddf0ea" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Dashboard" } [/block] The **Dashboard** tab lets you view statistics about your activity on the SAFE Network. [block:image] { "images": [ { "image": [ "https://files.readme.io/a4136ac-Screen_Shot_2016-08-01_at_1.48.44_AM.png", "Screen Shot 2016-08-01 at 1.48.44 AM.png", 1500, 1100, "#e5e5e6" ] } ] } [/block] [block:parameters] { "data": { "h-0": "Request Types", "0-0": "PUT", "1-0": "GET", "2-0": "POST", "3-0": "DELETE", "0-1": "Store new data on the network.", "1-1": "Retrieve data from the network.", "2-1": "Modify data on the network.", "3-1": "Delete data from the network.", "h-1": "Description" }, "cols": 2, "rows": 4 } [/block] [block:api-header] { "type": "basic", "title": "Logs" } [/block] The logs show you what your applications are doing. If you experience a bug or an issue, the logs might help you understand what the problem is. [block:image] { "images": [ { "image": [ "https://files.readme.io/90cd1af-Screen_Shot_2016-08-12_at_8.55.32_AM.png", "Screen Shot 2016-08-12 at 8.55.32 AM.png", 1500, 1100, "#def0ea" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Settings" } [/block] To access **.safenet** websites, make sure that the **Proxy Server** is enabled (it should be by default) and that you've followed the [Proxy Setup guide](doc:proxy-setup). [block:image] { "images": [ { "image": [ "https://files.readme.io/5ab91dd-Screen_Shot_2016-08-01_at_1.17.44_AM.png", "Screen Shot 2016-08-01 at 1.17.44 AM.png", 1500, 1100, "#ebebeb" ] } ] } [/block] [block:callout] { "type": "success", "title": "Setup an Automatic Proxy to browse the SAFE Network.", "body": "[Guide to setup a proxy on your machine](doc:proxy-setup)" } [/block] [block:api-header] { "type": "basic", "title": "Help" } [/block] If you need help with anything related to SAFE Launcher or SAFE Demo App, the best place to ask for help is the [SAFE Network Forum](https://safenetforum.org). Please use the [#support](https://forum.safenetwork.io/c/support) category when creating a new topic. [block:image] { "images": [ { "image": [ "https://files.readme.io/93a23e9-Screen_Shot_2016-08-11_at_11.01.54_PM.png", "Screen Shot 2016-08-11 at 11.01.54 PM.png", 1500, 1100, "#dcdbdc" ] } ] } [/block] **Where should I report issues?** To report issues and/or bugs with SAFE Launcher, please [open an issue on GitHub](https://github.com/maidsafe/safe_launcher/issues). You will need to have a GitHub account (they are free) to raise an issue.