# 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](/exo/getting-started/install.md).

## 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](/exo/manifests/migrate/procfiles.md) or [Docker Compose](/exo/manifests/migrate/compose.md)?

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](/exo/resources/videos.md)
* Explore the [command line interface](/exo/using-exo/cli.md)
* Study exo's core [concepts](/exo/using-exo/concepts.md)
* Consult the [manifest reference](/exo/manifests/manifest.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.deref.io/exo/getting-started/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.