# Quick Start

## Install

The easiest way to install exo is to run the following command:

```bash
curl -sL https://exo.deref.io/install | bash
```

For alternative installation methods, see [Installing exo](https://docs.deref.io/exo/getting-started/install).

## Create a Workspace

In your terminal, navigate to your project's root directory and initialize it:

```bash
exo init
```

If this directory is empty or otherwise does not contain an exo manifest, one will be created for you. Otherwise, the existing manifest will be imported automatically.

## Migrate to Exo

Is your project is already using [Procfiles](https://docs.deref.io/exo/manifests/migrate/procfiles) or [Docker Compose](https://docs.deref.io/exo/manifests/migrate/compose)?

If so, Exo is compatible with your existing configuration!

The initialization process from the previous step will automatically import compatible configuration and launch the specified processes, containers, and other components in the background. You can proceed to the next step.

Alternatively, to use exo as a drop-in replacement for `foreman` or `docker-compose up`, simply run:

```bash
exo run
```

The `run` command starts all of the components in the project and tails their logs. A run can be stopped with the standard `^c` terminal interrupt sequence.

## Using Exo

Exo supports both command line and graphical interfaces for most options. Development logs can be viewed either in the terminal or in your browser, whatever your preference:

```bash
# Launch GUI in browser.
exo gui

# Tail logs in terminal
exo logs
```

## Cleaning Up

When you're ready to work on something else, you may wish to shutdown all processes in your workspace:

```bash
exo stop
```

Or if you're done with this project forever, you can completely eliminate the exo state:

```bash
exo workspace destroy
```

Note that this will not affect your code files on disk.

## Next Steps

* Watch some [videos](https://docs.deref.io/exo/resources/videos)
* Explore the [command line interface](https://docs.deref.io/exo/using-exo/cli)
* Study exo's core [concepts](https://docs.deref.io/exo/using-exo/concepts)
* Consult the [manifest reference](https://docs.deref.io/exo/manifests/manifest)