github.com/dahs81/otto@v0.2.1-0.20160126165905-6400716cf085/website/source/docs/concepts/directory.html.md (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Directory"
     4  sidebar_current: "docs-concepts-directory"
     5  description: |-
     6    The "directory" is the name for the layer in Otto that stores
     7    the state of all infrastructures, applications, deploys, builds, etc.
     8  ---
     9  
    10  # Directory
    11  
    12  The "directory" is the name for the layer in Otto that stores
    13  the state of all infrastructures, applications, deploys, builds, etc.
    14  
    15  When you run `otto status`, the data that it outputs is coming from
    16  the directory. When an `otto deploy` happens, it verifies that all dependencies
    17  are deployed by querying the directory. When you create a new Appfile
    18  and compile it, that new application is inserted into the directory.
    19  
    20  The primary purpose of the directory is to enable shared state between
    21  multiple applications managed by Otto. By extension, the directory is
    22  the primary mechanism for [collaboration](/docs/concepts/collaboration.html)
    23  in Otto.
    24  
    25  ## Local Directory
    26  
    27  By default when you use Otto, it uses a local directory. You can see
    28  the database for the directory at `~/.otto.d/directory/otto.db`. Note
    29  that this file will only exist once you've used Otto before.
    30  
    31  Because the default directory is local, it is not suited for teamwork
    32  and collaboration. If one developer on your team deploys an application,
    33  and then you try to deploy an application, then Otto will deploy
    34  two separate isolated instances. This is because the directory isn't
    35  shared.
    36  
    37  Do not attempt to use network storage to share the directory file. This
    38  is unsafe and will not work.
    39  
    40  There is more information on collaboration with Otto on the
    41  [collaboration](/docs/concepts/collaboration.html) page.
    42  
    43  ## Shared Directories
    44  
    45  For Otto 0.1, only the local directory is available. A future version of
    46  Otto (in the very short term) will add support for remote directories, with
    47  the first remote directory being part of HashiCorp's
    48  [Atlas](https://atlas.hashicorp.com) offering. This directory service
    49  on its own will be free.