docs/_browser/local_browser.md

---
layout: usenew
description: Use a Blockstack ID with a DApp
permalink: /:collection/:path.html
---
# Install or uninstall the local browser
{:.no_toc}

If all you want to do is create, manage, and fund an identity and then interact
with DApps, you should [use the web edition](browser-introduction.html). If you
have concerns about net censorship, heightened security concerns, or want to
develop a DApp yourself, you may want to download and install the browser's
client edition; though it is not required. This page explains how to install or
uninstall the browser client on a workstation.

* TOC
{:toc}

## About the client install

Remember, for most users the Blockstack Browser web application should
suffice. You only need to install the client if you have additional, advanced
concerns about Internet or identity. Though not required, some DApp developrs
may find it useful to install the client edition.

The Blockstack Browser installer is a _multiple-context_ installer. If you
run it as a user, the installation is avalable only for that user. If you
install as administrator, the installation installs for all users. To find an
installer for your operating system, visit <a href="https://blockstack.org/install" target="\_blank">the browser installation page</a>.

### On Mac

Installation requires that you have macOS High Sierra 10.12 or higher. Do the following to install:

1. Download the OSX installer from <a href="https://blockstack.org/install" target="\_blank">the browser installation page</a>.
2. Double-click the downloaded DMG file to launch the installer.

   ![](images/ubuntu-browser.png)

3. Drag the Blockstack.app to the `Applications` folder.
4. Double-click the Blockstack.app to launch it.

   The system displays a notice about opening the file:

   ![](images/dmg-notice.png)

5. Choose **Open**.

   The system opens your default browser with the Blockstack Browser
   application, running from your machine (localhost). You'll also see the
   Blockstack icon in your machine's

   ![](images/browser-on-mac.png)

   If you have loaded an identity already via the Blockstack web application,
   you are already logged into the local application:

   ![](images/browser-on-mac-1.png)


### On Windows

Installation requires that you have Windows 10 or higher. Do the following to
install:

1. Download the Windows installer from from <a href="https://blockstack.org/install" target="\_blank">the browser installation page</a>.
2. Double-click the installer package to launch it.

   ![](images/windows-installer.png)

3. Open the Wiindows **Start** menu and click on the recently added **Blockstack Browser**.

   ![](images/windows-start.png)

   The system displays a Windows Security Alert.

   ![](images/windows-security.png)

4. Choose to **Allow access**.

   The system opens in the Blockstack Browser application.

    ![](images/windows-browser.png)


### On Linux

The Blockstack installation on Linux requires Docker. Before installing
Blockstack, <a href="https://docs.docker.com/install/" target="\_blank">install the version of Docker appropriate for your operating system</a>.

>**Note**: The Blockstack script used in this procedure runs `docker` commands. Depending on how you installed and configure Dockered on your system, it may or may not be necessary to have `root` or `sudo` privileges. For this reason, the commands below show the use of `sudo` when interacting with the script or the `docker` executable. If your installation allows running Docker with lower privileges, you can omit it.


1. Download the Linux installer from from <a href="https://blockstack.org/install" target="\_blank">the browser installation page</a>.

   This downloads a `Blockstack-for-Linux-v0.30.0.sh` script to your local drive.

2. Open a terminal and navigate to the directory containing the downloaded script.

   When the script downloads, it is not executable.

3. Set the executable bit on the file.

    ```bash
    $ chmod u+x Blockstack-for-Linux-v0.309.0.0.sh
    ```

4. Enter the command without any arguments to see the available subcommands.

    ```bash
    $ sudo ./Blockstack-for-Linux-v0.309.0.0.sh
    blockstack docker launcher commands:
    Install-protocol-handler -> install a protocol handler for blockstack:// links
    ...
    ```

5. Use the script to `pull` the Blockstack Docker images you need.


    ```bash
    $ sudo ./Blockstack-for-Linux-v0.309.0.0.sh pull
    ```

    Depending on your network speed, this can take some time.

7. Use the `docker image ls` command to confirm you have the image.

    ```bash
    $ sudo docker image Is
    REPOSITORY	TAG	IMAGE ID	CREATED
    quay.io/blockstack/blockstack-browser	v0.30.0	ad05fd844f59	2 days ago
    ```

8. Install the protocol handler

    ```bash
    $  sudo ./Blockstack-for-Linux-vO.30.0.sh install-protocol-handler

    Registering protocol handler
    ```

9. Start the Blockstack containers.

    ```bash
    $ sudo ./Blockstack-for-Linux-vO.30.0.sh start
    c3092592e59abe3559fdb49d070a7aa5e99165c7d9f2flla20ecaf4e0dfc2f46

    cd92f61ae473d54398da987f5023f5462b29c03f08584ebb3c9fIbb4cd790c69

    Registering protocol handler
    ```

    The system launches the Blockstack Browser application for you.

    ![](images/ubuntu-browser.png)

Until you stop the Blockstack containers, the application will continue to run
on your system. To display the status of the Blockstack containers, you can use
the `docker container ls` command.

{% raw %}
```bash
$ sudo docker container ls --format '{{.ID}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}\t{{.Names}}'
```
{% endraw %}

Use `./Blockstack-for-Linux-vO.30.0.sh stop` to stop the Blockstack Browser and its containers.


## Uninstall the browser

If you installed the browser using an installer, follow the instructions for
your operating system.

### On Mac

1. Quit the Blockstack application if it is running.

   ![](images/quit-blockstack.png)

2. Check if you have a Blockstack device and eject it if you do.

   ![](images/eject-blockstack.png)

3. Use the Finder to open the **Applications** folder.
4. Locate the Blockstack application.
5. Open your `Applications` folder and locate the **Blockstack.app**.
6. Drag the appliation to the trash.
7. Delete the `/Users/USERNAME/Library/Application Support/Blockstack` folder.

   From the command line:

   ```bash
   $ rm -r /Users/moxiegirl/Library/Application\ Support/Blockstack
   ```

### On Windows

1. Open the **Start** menu.
2. Click **Settings > System**.
3. Open for the **Apps & features** item.

   ![](images/eject-blockstack.png)

4. Locate the **Blockstack Browser** and choose **Uninstall**.

   ![](images/browser-uninstall.png)


### On Linux

Your Blockstack instalaltion relies on Docker containers and their associated
images. It also includes a supporting protocol handler you must remove. If you
installed Docker so that you can run Blockstack, you can uninstall Docker as well,
but that is not explained here.

Do the following to uninstall Blockstack:

1. Stop and remove the Docker containers if they are running.

    ```bash
    $ sudo ./Blockstack-for-Linux-vO.30.0.sh stop
    stopping the running blockstack-browser containers
    69a686799d4f
    56fc6189ff97
    69a686799d4f
    56fc6189ff97
    ```

2. Remove the associated Blockstack images.

    ```bash
    $ sudo docker image ls
    REPOSITORY	                          TAG	    IMAGE ID	    CREATED
    quay.io/blockstack/blockstack-browser	v0.30.0	ad05fd844f59	3 days ago
    $ sudo docker image rm ad05fd844f59

    Untagged : quay.io/blockstack/blockstack- browser :vO.30.0
    Untagged: quay.io/blockstack/blockstack-browser@sha256:b20c9514c56b99398fd4946af39e7537b807e85694943ac3b8807dlb3625833b
    Deleted: Sha256:ad05fd844f5948blee06a0a09228df946478393c0a7588cbc65dlb8817f5b34e
    Deleted: Sha256:7c3d0043f2ba01cf285f3fe09701b086c349b6380c2e42f25b31ac65c6626ec8
    Deleted: sha256:54ea2aa7d7d000e7483f299eeca9e5466fa86231f4cd4cld3c3096d97e61c5df
    Deleted: sha256:38e61054355adefc3c2de031462114a9946cfc0e44444a38a27d0f115aba0da2
    ....
    ```

3. Use the script to remove the protocol handler

    ```bash
    $ sudo ./Blockstack-for-Linux-vO.30.0.sh remove-protocol-handler
    ```

4. Delete the script.

    ```bash
    $ rm Blockstack-for-Linux-vO.30.0.sh
    ```