> ## Documentation Index
> Fetch the complete documentation index at: https://modal-devin.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an outpost

> Create a Devin Outposts outpost and deploy its Modal orchestrator.

Use the setup wizard when you need a new outpost. It can configure
Modal, create the outpost, store the Devin service user key, generate the application, and
deploy it.

## Before you begin

You need [uv](https://docs.astral.sh/uv/getting-started/installation/), Python 3.11
or newer, a Modal account, and a Devin organization with Outposts enabled. Have a
service user key from an **admin-scoped Enterprise service user** ready. This broad
scope is currently required to create and serve outposts. The wizard asks for the key
without echoing it.

<Steps>
  <Step title="Start the wizard">
    ```bash theme={null}
    uvx modal-devin init
    ```
  </Step>

  <Step title="Configure Modal if prompted">
    When local credentials are missing, accept **Set up Modal now?** to launch
    `modal setup`.
  </Step>

  <Step title="Name the outpost">
    Choose a durable name that identifies the execution environment, such as
    `gpu-h200` or `production-vpc`. It appears as a machine option in Devin, and the
    wizard also uses it for the generated filename and Modal resources.
  </Step>

  <Step title="Provide the Devin service user key">
    Enter the key from the admin-scoped Enterprise service user. The wizard uses it
    to create the outpost and offers to store it as a Modal Secret. Input is hidden,
    and the generated application excludes the key.
  </Step>

  <Step title="Deploy">
    Accept **Deploy now?** The wizard deploys the generated Modal application and
    prints the result.
  </Step>
</Steps>

## If setup fails

The wizard avoids overwriting existing files and reports any remote resource that
may need cleanup. Follow the printed recovery step, then run
`uvx modal-devin init` again after fixing the underlying problem.

## Next steps

<Columns cols={2}>
  <Card title="Customize the outpost" icon="paintbrush" href="/tutorials/custom-workspace">
    Add project source and tools to new sessions.
  </Card>

  <Card title="Configure runtime behavior" icon="sliders" href="/guides/runtime-configuration">
    Change session duration, snapshot retention, polling, and logs.
  </Card>
</Columns>