==================================
Configuration reference (AER 2.31)
==================================

.. raw:: html

    <div class="contents local topic" id="contents">
    <ul class="simple">
    <li><a class="reference internal" href="#usernames" id="id6">Usernames</a><ul>
    <li><a class="reference internal" href="#user-regex" id="id7">USER_REGEX</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#database" id="id8">Database</a><ul>
    <li><a class="reference internal" href="#mongo-url" id="id9">MONGO_URL</a></li>
    <li><a class="reference internal" href="#mongo-dbname" id="id10">MONGO_DBNAME</a></li>
    <li><a class="reference internal" href="#mq-dbname" id="id11">MQ_DBNAME</a></li>
    <li><a class="reference internal" href="#mongo-replica-set" id="id12">MONGO_REPLICA_SET</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#file-storage" id="id13">File storage</a><ul>
    <li><a class="reference internal" href="#storage-type" id="id14">storage_type</a></li>
    <li><a class="reference internal" href="#fs-storage-root" id="id15">fs_storage_root</a></li>
    <li><a class="reference internal" href="#keyname-full-path" id="id16">keyname_full_path</a></li>
    <li><a class="reference internal" href="#package-bucket-id" id="id17">PACKAGE_BUCKET_ID</a></li>
    <li><a class="reference internal" href="#s3-region-name" id="id18">S3_REGION_NAME</a></li>
    <li><a class="reference internal" href="#s3-server-side-encryption" id="id19">S3_SERVER_SIDE_ENCRYPTION</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#notebooks" id="id20">Notebooks</a><ul>
    <li><a class="reference internal" href="#max-ipynb-size" id="id21">MAX_IPYNB_SIZE</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#web-server" id="id22">Web server</a><ul>
    <li><a class="reference internal" href="#server-name" id="id23">SERVER_NAME</a></li>
    <li><a class="reference internal" href="#port" id="id24">port</a></li>
    <li><a class="reference internal" href="#subdomains" id="id25">subdomains</a></li>
    <li><a class="reference internal" href="#session-cookie-domain" id="id26">SESSION_COOKIE_DOMAIN</a></li>
    <li><a class="reference internal" href="#user-content-domain" id="id27">USER_CONTENT_DOMAIN</a></li>
    <li><a class="reference internal" href="#ssl-options" id="id28">ssl_options</a><ul>
    <li><a class="reference internal" href="#certfile" id="id29">certfile</a></li>
    <li><a class="reference internal" href="#keyfile" id="id30">keyfile</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#preferred-url-scheme" id="id31">PREFERRED_URL_SCHEME</a></li>
    <li><a class="reference internal" href="#gunicorn" id="id32">gunicorn</a><ul>
    <li><a class="reference internal" href="#timeout" id="id33">timeout</a></li>
    <li><a class="reference internal" href="#workers" id="id34">workers</a></li>
    </ul>
    </li>
    </ul>
    </li>
    <li><a class="reference internal" href="#authentication" id="id35">Authentication</a><ul>
    <li><a class="reference internal" href="#auth-type" id="id36">AUTH_TYPE</a></li>
    <li><a class="reference internal" href="#krb5-hostname" id="id37">KRB5_HOSTNAME</a></li>
    <li><a class="reference internal" href="#krb5-service-name" id="id38">KRB5_SERVICE_NAME</a></li>
    <li><a class="reference internal" href="#krb5-ktname" id="id39">KRB5_KTNAME</a></li>
    <li><a class="reference internal" href="#ldap" id="id40">LDAP</a></li>
    <li><a class="reference internal" href="#lock-down" id="id41">LOCK_DOWN</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#email" id="id42">Email</a><ul>
    <li><a class="reference internal" href="#smtp-host" id="id43">SMTP_HOST</a></li>
    <li><a class="reference internal" href="#smtp-port" id="id44">SMTP_PORT</a></li>
    <li><a class="reference internal" href="#smtp-tls" id="id45">SMTP_TLS</a></li>
    <li><a class="reference internal" href="#smtp-username" id="id46">SMTP_USERNAME</a></li>
    <li><a class="reference internal" href="#smtp-password" id="id47">SMTP_PASSWORD</a></li>
    <li><a class="reference internal" href="#use-ses" id="id48">USE_SES</a></li>
    <li><a class="reference internal" href="#return-address" id="id49">RETURN_ADDRESS</a></li>
    <li><a class="reference internal" href="#allow-duplicated-emails" id="id50">ALLOW_DUPLICATED_EMAILS</a></li>
    <li><a class="reference internal" href="#require-email-validation" id="id51">require_email_validation</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#advanced" id="id52">Advanced</a><ul>
    <li><a class="reference internal" href="#parcels-root" id="id53">PARCELS_ROOT</a></li>
    <li><a class="reference internal" href="#parcel-distro-suffixes" id="id54">PARCEL_DISTRO_SUFFIXES</a></li>
    <li><a class="reference internal" href="#default-channels" id="id55">DEFAULT_CHANNELS</a></li>
    <li><a class="reference internal" href="#conda-cache-size" id="id56">CONDA_CACHE_SIZE</a></li>
    <li><a class="reference internal" href="#cache-method" id="id57">CACHE_METHOD</a></li>
    </ul>
    </li>
    </ul>
    </div>
    <p>Anaconda Repository will load configuration files with the extension <code class="docutils literal"><span class="pre">.yaml</span></code>
    from the following locations:</p>
    <ul class="simple">
    <li><code class="docutils literal"><span class="pre">/etc/binstar/</span></code></li>
    <li><code class="docutils literal"><span class="pre">/etc/anaconda-server/</span></code></li>
    <li><code class="docutils literal"><span class="pre">$PREFIX/etc/anaconda-server</span></code></li>
    </ul>
    <p><code class="docutils literal"><span class="pre">$PREFIX</span></code> is the location where Anaconda Repository was installed.</p>
    <p>Files are loaded from these directories in order, with later files overriding earlier
    files. Files are loaded from each directory in alphabetical order.</p>
    <p>If an environment variable ANACONDA_SERVER_CONFIG is set with the path of a
    configuration file, this file is loaded after the three already listed. Its
    settings will override any conflicting settings in the earlier files.</p>
    <p>Each configuration setting variable can have its value set with the
    <code class="docutils literal"><span class="pre">anaconda-server-config</span> <span class="pre">--set</span></code> command, or by editing a configuration file.</p>
    <p>For example, you can set a value named VALUE_ONE to 50 by adding this to a configuration file:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">VALUE_ONE</span><span class="p">:</span> <span class="mi">50</span>
    </pre></div>
    </div>
    <p>Or you can set a value named VALUE_ONE to 50 with this command:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">anaconda</span><span class="o">-</span><span class="n">server</span><span class="o">-</span><span class="n">config</span> <span class="o">--</span><span class="nb">set</span> <span class="n">VALUE_ONE</span> <span class="mi">50</span>
    </pre></div>
    </div>
    <div class="section" id="usernames">
    <h2><a class="toc-backref" href="#id6">Usernames</a><a class="headerlink" href="#usernames" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="user-regex">
    <h3><a class="toc-backref" href="#id7">USER_REGEX</a><a class="headerlink" href="#user-regex" title="Permalink to this headline">¶</a></h3>
    <p>A regular expression that defines the allowable user names.</p>
    <p>For example, this setting specifies that user names will contain only lowercase letters and the period, plus, and minus characters (<code class="docutils literal"><span class="pre">.</span></code> <code class="docutils literal"><span class="pre">+</span></code> and <code class="docutils literal"><span class="pre">-</span></code>):</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">USER_REGEX</span><span class="p">:</span> <span class="s1">&#39;^[a-z.+-]+$&#39;</span>
    </pre></div>
    </div>
    <p>NOTE: The default value for <code class="docutils literal"><span class="pre">USER_REGEX</span></code> is <code class="docutils literal"><span class="pre">^[a-z0-9_][a-z0-9_-]+$</span></code> which translates to: at least one alphanumeric character or underscore, followed by zero or more alphanumeric, dash or underscore characters.</p>
    <p>NOTE: Escape any extra instances of the single quote character <code class="docutils literal"><span class="pre">'</span></code> as <code class="docutils literal"><span class="pre">\'</span></code>, and do not use the slash and ampersand characters <code class="docutils literal"><span class="pre">/</span></code> and <code class="docutils literal"><span class="pre">&amp;</span></code> which have special meanings in URLs.</p>
    <p>NOTE: If USER_REGEX is changed and the server is restarted, existing usernames that do not match the new USER_REGEX will not cause errors.</p>
    </div>
    </div>
    <div class="section" id="database">
    <h2><a class="toc-backref" href="#id8">Database</a><a class="headerlink" href="#database" title="Permalink to this headline">¶</a></h2>
    <p>Anaconda Repository uses MongoDB as the database backend.</p>
    <div class="section" id="mongo-url">
    <h3><a class="toc-backref" href="#id9">MONGO_URL</a><a class="headerlink" href="#mongo-url" title="Permalink to this headline">¶</a></h3>
    <p>A <a class="reference external" href="https://docs.mongodb.com/manual/reference/connection-string/">MongoDB connection URI</a> used
    to connect to the MongoDB database server. It can be used to configure the hostname and port, as well
    as database authentication.</p>
    <p>For example:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">MONGO_URL</span><span class="p">:</span> <span class="n">mongodb</span><span class="p">:</span><span class="o">//</span><span class="n">anaconda</span><span class="o">-</span><span class="n">server</span><span class="p">:</span><span class="n">Pa55w0rd</span><span class="nd">@mongodb</span><span class="o">.</span><span class="n">serv</span><span class="o">/</span>
    </pre></div>
    </div>
    </div>
    <div class="section" id="mongo-dbname">
    <h3><a class="toc-backref" href="#id10">MONGO_DBNAME</a><a class="headerlink" href="#mongo-dbname" title="Permalink to this headline">¶</a></h3>
    <p>The MongoDB database where Anaconda Repository will store its data.</p>
    </div>
    <div class="section" id="mq-dbname">
    <h3><a class="toc-backref" href="#id11">MQ_DBNAME</a><a class="headerlink" href="#mq-dbname" title="Permalink to this headline">¶</a></h3>
    <p>The MongoDB database where Anaconda Repository will store data used for asynchronous processing.</p>
    </div>
    <div class="section" id="mongo-replica-set">
    <h3><a class="toc-backref" href="#id12">MONGO_REPLICA_SET</a><a class="headerlink" href="#mongo-replica-set" title="Permalink to this headline">¶</a></h3>
    <p>The name of a <a class="reference external" href="https://docs.mongodb.com/manual/replication/">MongoDB replica set</a> Anaconda Repository will
    connect to after establishing a connection to the database server.</p>
    </div>
    </div>
    <div class="section" id="file-storage">
    <h2><a class="toc-backref" href="#id13">File storage</a><a class="headerlink" href="#file-storage" title="Permalink to this headline">¶</a></h2>
    <p>Anaconda Repository can serve package contents from a local file-system, or from Amazon Web Services Simple Storage Service
    (AWS S3).</p>
    <div class="section" id="storage-type">
    <h3><a class="toc-backref" href="#id14">storage_type</a><a class="headerlink" href="#storage-type" title="Permalink to this headline">¶</a></h3>
    <p>The storage mechanism to use. Valid choices are <code class="docutils literal"><span class="pre">fs</span></code> (for file-system storage) or <code class="docutils literal"><span class="pre">s3</span></code> (for AWS S3 storage).</p>
    </div>
    <div class="section" id="fs-storage-root">
    <h3><a class="toc-backref" href="#id15">fs_storage_root</a><a class="headerlink" href="#fs-storage-root" title="Permalink to this headline">¶</a></h3>
    <p>The absolute path to a directory where Anaconda Repository will store all uploaded packages, if configured to use
    file-system storage.</p>
    </div>
    <div class="section" id="keyname-full-path">
    <h3><a class="toc-backref" href="#id16">keyname_full_path</a><a class="headerlink" href="#keyname-full-path" title="Permalink to this headline">¶</a></h3>
    <p>When this option is set, Repository stores the files by full paths and not just
    by hashes. This way a tensorflow file uploaded by the user <cite>Bob</cite> will be stored
    on <code class="docutils literal"><span class="pre">&lt;fs_storage_root&gt;/Bob/tensorflow/osx-64/tensorflow-1.1.0-np112py36_0.tar.bz2-594ac56e7e042600648defdb</span></code>.</p>
    <p>NOTE: If you rename a user or transfer a file to a different user, the file
    location on the storage does not change, so the storage path does not always
    contain the current file owner and their user name.</p>
    </div>
    <div class="section" id="package-bucket-id">
    <h3><a class="toc-backref" href="#id17">PACKAGE_BUCKET_ID</a><a class="headerlink" href="#package-bucket-id" title="Permalink to this headline">¶</a></h3>
    <p>The name of an AWS S3 bucket where Anaconda Repository will store uploaded packages, if configured to use AWS S3 storage.</p>
    <p>You can identify the name of your bucket by the <code class="docutils literal"><span class="pre">&lt;bucket&gt;</span></code> in your <code class="docutils literal"><span class="pre">http://&lt;bucket&gt;.s3.amazonaws.com</span></code> URL.</p>
    </div>
    <div class="section" id="s3-region-name">
    <h3><a class="toc-backref" href="#id18">S3_REGION_NAME</a><a class="headerlink" href="#s3-region-name" title="Permalink to this headline">¶</a></h3>
    <p>The S3 region that the bucket is located in. The available regions can be found in the
    <a class="reference external" href="http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region">Amazon AWS documentation</a>.</p>
    </div>
    <div class="section" id="s3-server-side-encryption">
    <h3><a class="toc-backref" href="#id19">S3_SERVER_SIDE_ENCRYPTION</a><a class="headerlink" href="#s3-server-side-encryption" title="Permalink to this headline">¶</a></h3>
    <p>This can be set to <code class="docutils literal"><span class="pre">AES256</span></code> to enable
    <a class="reference external" href="http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html">server-side encryption</a>
    for packages stored in the S3 bucket.</p>
    </div>
    </div>
    <div class="section" id="notebooks">
    <h2><a class="toc-backref" href="#id20">Notebooks</a><a class="headerlink" href="#notebooks" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="max-ipynb-size">
    <span id="repo-max-ipynb-size"></span><h3><a class="toc-backref" href="#id21">MAX_IPYNB_SIZE</a><a class="headerlink" href="#max-ipynb-size" title="Permalink to this headline">¶</a></h3>
    <p>This is the maximum allowed size when uploading notebooks to the server. The
    default is 25 MB. This variable can be set in <code class="docutils literal"><span class="pre">config.yaml</span></code>.</p>
    </div>
    </div>
    <div class="section" id="web-server">
    <h2><a class="toc-backref" href="#id22">Web server</a><a class="headerlink" href="#web-server" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="server-name">
    <span id="id1"></span><h3><a class="toc-backref" href="#id23">SERVER_NAME</a><a class="headerlink" href="#server-name" title="Permalink to this headline">¶</a></h3>
    <p>The name and port number of the server. This option is required for subdomain support.</p>
    <p>For example:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">SERVER_NAME</span><span class="p">:</span> <span class="n">anaconda</span><span class="o">.</span><span class="n">srv</span><span class="p">:</span><span class="mi">8080</span>
    </pre></div>
    </div>
    </div>
    <div class="section" id="port">
    <h3><a class="toc-backref" href="#id24">port</a><a class="headerlink" href="#port" title="Permalink to this headline">¶</a></h3>
    <p>The port number of the server. Defaults to <code class="docutils literal"><span class="pre">8080</span></code>.</p>
    </div>
    <div class="section" id="subdomains">
    <h3><a class="toc-backref" href="#id25">subdomains</a><a class="headerlink" href="#subdomains" title="Permalink to this headline">¶</a></h3>
    <p>If set to <code class="docutils literal"><span class="pre">true</span></code>, Anaconda Repository will serve <code class="docutils literal"><span class="pre">conda</span></code> package from a separate subdomain.
    Defaults to <code class="docutils literal"><span class="pre">false</span></code>.</p>
    <p>For example:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">SERVER_NAME</span><span class="p">:</span> <span class="n">anaconda</span><span class="o">.</span><span class="n">srv</span><span class="p">:</span><span class="mi">8080</span>
    <span class="n">subdomains</span><span class="p">:</span> <span class="n">true</span>
    </pre></div>
    </div>
    <p>Allows access to conda packages at <code class="docutils literal"><span class="pre">http://conda.anaconda.srv:8080/</span></code>.</p>
    </div>
    <div class="section" id="session-cookie-domain">
    <h3><a class="toc-backref" href="#id26">SESSION_COOKIE_DOMAIN</a><a class="headerlink" href="#session-cookie-domain" title="Permalink to this headline">¶</a></h3>
    <p>The domain that Anaconda Repository will set on the session cookie. If this is not set, the cookie will be valid
    for all subdomains of <code class="docutils literal"><span class="pre">SERVER_NAME</span></code>. See <a class="reference internal" href="advanced.html#securing-user-created-content"><span class="std std-ref">here</span></a>.</p>
    </div>
    <div class="section" id="user-content-domain">
    <h3><a class="toc-backref" href="#id27">USER_CONTENT_DOMAIN</a><a class="headerlink" href="#user-content-domain" title="Permalink to this headline">¶</a></h3>
    <p>As a cross-site scripting (XSS) protection, notebook content can be served from a separate domain name. If this option is
    configured, Anaconda Repository will only serve rendered notebooks from this domain.</p>
    <p>See <a class="reference internal" href="advanced.html#securing-user-created-content"><span class="std std-ref">here</span></a>.</p>
    </div>
    <div class="section" id="ssl-options">
    <h3><a class="toc-backref" href="#id28">ssl_options</a><a class="headerlink" href="#ssl-options" title="Permalink to this headline">¶</a></h3>
    <p>Anaconda Repository can serve content over HTTPS, using user-provided SSL certificates.</p>
    <p>For example:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">ssl_options</span><span class="p">:</span>
        <span class="n">certfile</span><span class="p">:</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">anaconda</span><span class="o">-</span><span class="n">server</span><span class="o">/</span><span class="n">server</span><span class="o">.</span><span class="n">crt</span>
        <span class="n">keyfile</span><span class="p">:</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">anaconda</span><span class="o">-</span><span class="n">server</span><span class="o">/</span><span class="n">server</span><span class="o">.</span><span class="n">key</span>
    <span class="n">PREFERRED_URL_SCHEME</span><span class="p">:</span> <span class="n">https</span>
    </pre></div>
    </div>
    <div class="section" id="certfile">
    <h4><a class="toc-backref" href="#id29">certfile</a><a class="headerlink" href="#certfile" title="Permalink to this headline">¶</a></h4>
    <p>The absolute path to a PEM-formatted X.509 certificate file.</p>
    </div>
    <div class="section" id="keyfile">
    <h4><a class="toc-backref" href="#id30">keyfile</a><a class="headerlink" href="#keyfile" title="Permalink to this headline">¶</a></h4>
    <p>The absolute path to a PEM-formatted private key for the associated certificate.</p>
    </div>
    </div>
    <div class="section" id="preferred-url-scheme">
    <h3><a class="toc-backref" href="#id31">PREFERRED_URL_SCHEME</a><a class="headerlink" href="#preferred-url-scheme" title="Permalink to this headline">¶</a></h3>
    <p>The preferred scheme that will be used to generate URLs. Set this to <code class="docutils literal"><span class="pre">https</span></code> if HTTPS is configured.</p>
    </div>
    <div class="section" id="gunicorn">
    <h3><a class="toc-backref" href="#id32">gunicorn</a><a class="headerlink" href="#gunicorn" title="Permalink to this headline">¶</a></h3>
    <p>Anaconda Repository uses <a class="reference external" href="http://gunicorn.org/">Gunicorn</a>. The most commonly used options are <code class="docutils literal"><span class="pre">timeout</span></code> and <code class="docutils literal"><span class="pre">workers</span></code>.
    A complete list of settings can be found in <a class="reference external" href="http://docs.gunicorn.org/en/latest/settings.html#settings">Gunicorn&#8217;s documentation</a>.</p>
    <p>For example:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">gunicorn</span><span class="p">:</span>
        <span class="n">timeout</span><span class="p">:</span> <span class="mi">60</span>
        <span class="n">workers</span><span class="p">:</span> <span class="mi">5</span>
    </pre></div>
    </div>
    <div class="section" id="timeout">
    <h4><a class="toc-backref" href="#id33">timeout</a><a class="headerlink" href="#timeout" title="Permalink to this headline">¶</a></h4>
    <p>The number of seconds that a worker is allowed to process a request for, before being forcefully terminated.
    Defaults to 120.</p>
    </div>
    <div class="section" id="workers">
    <h4><a class="toc-backref" href="#id34">workers</a><a class="headerlink" href="#workers" title="Permalink to this headline">¶</a></h4>
    <p>The number of workers that gunicorn will spawn to serve Anaconda Repository. Defaults to 2 × the number of CPUs + 1.</p>
    </div>
    </div>
    </div>
    <div class="section" id="authentication">
    <h2><a class="toc-backref" href="#id35">Authentication</a><a class="headerlink" href="#authentication" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="auth-type">
    <h3><a class="toc-backref" href="#id36">AUTH_TYPE</a><a class="headerlink" href="#auth-type" title="Permalink to this headline">¶</a></h3>
    <p>The method Anaconda Repository will use to authenticate users. Valid choices are <code class="docutils literal"><span class="pre">NATIVE</span></code> (for built-in authentication),
    <code class="docutils literal"><span class="pre">KERBEROS</span></code> (for Kerberos) and <code class="docutils literal"><span class="pre">LDAP</span></code>.</p>
    </div>
    <div class="section" id="krb5-hostname">
    <h3><a class="toc-backref" href="#id37">KRB5_HOSTNAME</a><a class="headerlink" href="#krb5-hostname" title="Permalink to this headline">¶</a></h3>
    <p>See <a class="reference internal" href="advanced.html#kerberos-configuration-options"><span class="std std-ref">Kerberos Configuration Options</span></a>.</p>
    </div>
    <div class="section" id="krb5-service-name">
    <h3><a class="toc-backref" href="#id38">KRB5_SERVICE_NAME</a><a class="headerlink" href="#krb5-service-name" title="Permalink to this headline">¶</a></h3>
    <p>See <a class="reference internal" href="advanced.html#kerberos-configuration-options"><span class="std std-ref">Kerberos Configuration Options</span></a>.</p>
    </div>
    <div class="section" id="krb5-ktname">
    <h3><a class="toc-backref" href="#id39">KRB5_KTNAME</a><a class="headerlink" href="#krb5-ktname" title="Permalink to this headline">¶</a></h3>
    <p>See <a class="reference internal" href="advanced.html#kerberos-configuration-options"><span class="std std-ref">Kerberos Configuration Options</span></a>.</p>
    </div>
    <div class="section" id="ldap">
    <h3><a class="toc-backref" href="#id40">LDAP</a><a class="headerlink" href="#ldap" title="Permalink to this headline">¶</a></h3>
    <p>Options for configuring LDAP authentication and group synchronization.</p>
    <p>For example:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">LDAP</span><span class="p">:</span>
        <span class="n">URI</span><span class="p">:</span> <span class="n">ldap</span><span class="p">:</span><span class="o">//</span><span class="n">ldap</span><span class="o">.</span><span class="n">server</span>
        <span class="n">BIND_DN</span><span class="p">:</span> <span class="n">cn</span><span class="o">=</span><span class="n">Anaconda</span> <span class="n">Repository</span><span class="p">,</span><span class="n">cn</span><span class="o">=</span><span class="n">Users</span><span class="p">,</span><span class="n">dc</span><span class="o">=</span><span class="n">example</span><span class="p">,</span><span class="n">dc</span><span class="o">=</span><span class="n">com</span>
        <span class="n">BIND_AUTH</span><span class="p">:</span> <span class="n">Pa55w0rd</span>

        <span class="n">USER_SEARCH</span><span class="p">:</span>
            <span class="n">base</span><span class="p">:</span> <span class="n">cn</span><span class="o">=</span><span class="n">Users</span><span class="p">,</span><span class="n">dc</span><span class="o">=</span><span class="n">example</span><span class="p">,</span><span class="n">dc</span><span class="o">=</span><span class="n">com</span>
            <span class="nb">filter</span><span class="p">:</span> <span class="n">sAMAccountName</span><span class="o">=%</span><span class="p">(</span><span class="n">username</span><span class="p">)</span><span class="n">s</span>

        <span class="n">KEY_MAP</span><span class="p">:</span>
            <span class="n">name</span><span class="p">:</span> <span class="n">cn</span>

        <span class="n">OPTIONS</span><span class="p">:</span>
            <span class="n">OPT_NETWORK_TIMEOUT</span><span class="p">:</span> <span class="mi">60</span>
            <span class="n">OPT_TIMEOUT</span><span class="p">:</span> <span class="mi">60</span>
    </pre></div>
    </div>
    <p>See <a class="reference internal" href="advanced.html#ldap-configuration-options"><span class="std std-ref">LDAP and TLS Configuration Options</span></a>.</p>
    </div>
    <div class="section" id="lock-down">
    <span id="repo-admin-reference-emails"></span><h3><a class="toc-backref" href="#id41">LOCK_DOWN</a><a class="headerlink" href="#lock-down" title="Permalink to this headline">¶</a></h3>
    <p>Makes all views inaccessible to anonymous users, except the welcome page and login form.</p>
    </div>
    </div>
    <div class="section" id="email">
    <h2><a class="toc-backref" href="#id42">Email</a><a class="headerlink" href="#email" title="Permalink to this headline">¶</a></h2>
    <p>Anaconda Repository can be configured to send email for various reasons,
    including to reset forgotten usernames and passwords. Email can be sent using
    SMTP protocol, or through Amazon Web Services Simple Email Service (AWS SES).</p>
    <div class="section" id="smtp-host">
    <h3><a class="toc-backref" href="#id43">SMTP_HOST</a><a class="headerlink" href="#smtp-host" title="Permalink to this headline">¶</a></h3>
    <p>The hostname of the SMTP server.</p>
    </div>
    <div class="section" id="smtp-port">
    <h3><a class="toc-backref" href="#id44">SMTP_PORT</a><a class="headerlink" href="#smtp-port" title="Permalink to this headline">¶</a></h3>
    <p>The port of the SMTP server.</p>
    </div>
    <div class="section" id="smtp-tls">
    <h3><a class="toc-backref" href="#id45">SMTP_TLS</a><a class="headerlink" href="#smtp-tls" title="Permalink to this headline">¶</a></h3>
    <p>If set to <code class="docutils literal"><span class="pre">true</span></code>, Anaconda Repository will attempt an SSL connection to the SMTP server.</p>
    </div>
    <div class="section" id="smtp-username">
    <h3><a class="toc-backref" href="#id46">SMTP_USERNAME</a><a class="headerlink" href="#smtp-username" title="Permalink to this headline">¶</a></h3>
    <p>The username to authenticate against the SMTP server before attempting to send email.</p>
    </div>
    <div class="section" id="smtp-password">
    <h3><a class="toc-backref" href="#id47">SMTP_PASSWORD</a><a class="headerlink" href="#smtp-password" title="Permalink to this headline">¶</a></h3>
    <p>The password to authenticate against the SMTP server before attempting to send email.</p>
    </div>
    <div class="section" id="use-ses">
    <h3><a class="toc-backref" href="#id48">USE_SES</a><a class="headerlink" href="#use-ses" title="Permalink to this headline">¶</a></h3>
    <p>If set to <code class="docutils literal"><span class="pre">true</span></code>, Anaconda Repository will send email with AWS SES. To authenticate to AWS,
    the server should be configured with
    <a class="reference external" href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/control-user-access.html">an appropriate IAM role</a>,
    or have credentials specified in a
    <a class="reference external" href="http://boto.cloudhackers.com/en/latest/boto_config_tut.html#credentials">Boto configuration file</a>.</p>
    </div>
    <div class="section" id="return-address">
    <h3><a class="toc-backref" href="#id49">RETURN_ADDRESS</a><a class="headerlink" href="#return-address" title="Permalink to this headline">¶</a></h3>
    <p>The <code class="docutils literal"><span class="pre">From:</span></code> email address that Anaconda Repository will use as sender.</p>
    </div>
    <div class="section" id="allow-duplicated-emails">
    <h3><a class="toc-backref" href="#id50">ALLOW_DUPLICATED_EMAILS</a><a class="headerlink" href="#allow-duplicated-emails" title="Permalink to this headline">¶</a></h3>
    <p>If set to <code class="docutils literal"><span class="pre">true</span></code>, Anaconda Repository will allow different users to share the same <cite>email</cite> or <cite>secondary email</cite>.
    Defaults to <code class="docutils literal"><span class="pre">false</span></code></p>
    </div>
    <div class="section" id="require-email-validation">
    <h3><a class="toc-backref" href="#id51">require_email_validation</a><a class="headerlink" href="#require-email-validation" title="Permalink to this headline">¶</a></h3>
    <p>If set to <code class="docutils literal"><span class="pre">true</span></code>, Anaconda Repository will email new users a unique token to validate their
    email address before permitting them to log in.</p>
    </div>
    </div>
    <div class="section" id="advanced">
    <h2><a class="toc-backref" href="#id52">Advanced</a><a class="headerlink" href="#advanced" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="parcels-root">
    <span id="id3"></span><h3><a class="toc-backref" href="#id53">PARCELS_ROOT</a><a class="headerlink" href="#parcels-root" title="Permalink to this headline">¶</a></h3>
    <p>The prefix that Cloudera parcels are generated with. Defaults to <code class="docutils literal"><span class="pre">/opt/cloudera/parcels</span></code>.</p>
    </div>
    <div class="section" id="parcel-distro-suffixes">
    <span id="id4"></span><h3><a class="toc-backref" href="#id54">PARCEL_DISTRO_SUFFIXES</a><a class="headerlink" href="#parcel-distro-suffixes" title="Permalink to this headline">¶</a></h3>
    <p>The distributions that Cloudera parcels are generated for. Defaults to
    <code class="docutils literal"><span class="pre">['el5',</span> <span class="pre">'el6',</span> <span class="pre">'el7',</span> <span class="pre">'lucid',</span> <span class="pre">'precise',</span> <span class="pre">'trusty',</span> <span class="pre">'wheezy',</span> <span class="pre">'jessie',</span> <span class="pre">'squeeze',</span> <span class="pre">'sles11',</span> <span class="pre">'sles12']</span></code>.</p>
    <p>For example, if you only wish to support Ubuntu:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">PARCEL_DISTRO_SUFFIXES</span><span class="p">:</span>
        <span class="o">-</span> <span class="n">lucid</span>
        <span class="o">-</span> <span class="n">precise</span>
        <span class="o">-</span> <span class="n">trusty</span>
    </pre></div>
    </div>
    </div>
    <div class="section" id="default-channels">
    <span id="id5"></span><h3><a class="toc-backref" href="#id55">DEFAULT_CHANNELS</a><a class="headerlink" href="#default-channels" title="Permalink to this headline">¶</a></h3>
    <p>The Anaconda Repository accounts that environments installed with the
    <a class="reference internal" href="custom-anaconda-installers.html#bundled-installers"><span class="std std-ref">bundled Anaconda distributions</span></a> will pull packages from.
    Defaults to <code class="docutils literal"><span class="pre">['anaconda',</span> <span class="pre">'r-channel']</span></code>.</p>
    <p>For example, to add an additional <code class="docutils literal"><span class="pre">custom</span></code> account:</p>
    <div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">DEFAULT_CHANNELS</span><span class="p">:</span>
        <span class="o">-</span> <span class="n">anaconda</span>
        <span class="o">-</span> <span class="n">r</span><span class="o">-</span><span class="n">channel</span>
        <span class="o">-</span> <span class="n">custom</span>
    </pre></div>
    </div>
    </div>
    <div class="section" id="conda-cache-size">
    <h3><a class="toc-backref" href="#id56">CONDA_CACHE_SIZE</a><a class="headerlink" href="#conda-cache-size" title="Permalink to this headline">¶</a></h3>
    <p>The maximum size (in bytes) of the <code class="docutils literal"><span class="pre">repodata.json</span></code> requests cache. Set to <code class="docutils literal"><span class="pre">0</span></code> to disable <code class="docutils literal"><span class="pre">repodata.json</span></code>
    caching. Default: 1Gb. When the maximum size is reached, the 10 least recently used entries of the cache are
    evicted.</p>
    </div>
    <div class="section" id="cache-method">
    <h3><a class="toc-backref" href="#id57">CACHE_METHOD</a><a class="headerlink" href="#cache-method" title="Permalink to this headline">¶</a></h3>
    <p>The method used for caching repodata info. It can either be <code class="docutils literal"><span class="pre">tempfile</span></code> (the prior method of caching) or <code class="docutils literal"><span class="pre">diskcache</span></code>,
    which uses SQLite as a back-end. Default: <code class="docutils literal"><span class="pre">diskcache</span></code>.</p>
    </div>
    </div>
