==================================
Configuration reference (AER 2.25)
==================================

.. 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="#package-bucket-id" id="id16">PACKAGE_BUCKET_ID</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#web-server" id="id17">Web server</a><ul>
    <li><a class="reference internal" href="#server-name" id="id18">SERVER_NAME</a></li>
    <li><a class="reference internal" href="#port" id="id19">port</a></li>
    <li><a class="reference internal" href="#subdomains" id="id20">subdomains</a></li>
    <li><a class="reference internal" href="#session-cookie-domain" id="id21">SESSION_COOKIE_DOMAIN</a></li>
    <li><a class="reference internal" href="#user-content-domain" id="id22">USER_CONTENT_DOMAIN</a></li>
    <li><a class="reference internal" href="#ssl-options" id="id23">ssl_options</a><ul>
    <li><a class="reference internal" href="#certfile" id="id24">certfile</a></li>
    <li><a class="reference internal" href="#keyfile" id="id25">keyfile</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#preferred-url-scheme" id="id26">PREFERRED_URL_SCHEME</a></li>
    <li><a class="reference internal" href="#gunicorn" id="id27">gunicorn</a><ul>
    <li><a class="reference internal" href="#timeout" id="id28">timeout</a></li>
    <li><a class="reference internal" href="#workers" id="id29">workers</a></li>
    </ul>
    </li>
    </ul>
    </li>
    <li><a class="reference internal" href="#authentication" id="id30">Authentication</a><ul>
    <li><a class="reference internal" href="#auth-type" id="id31">AUTH_TYPE</a></li>
    <li><a class="reference internal" href="#krb5-hostname" id="id32">KRB5_HOSTNAME</a></li>
    <li><a class="reference internal" href="#krb5-service-name" id="id33">KRB5_SERVICE_NAME</a></li>
    <li><a class="reference internal" href="#krb5-ktname" id="id34">KRB5_KTNAME</a></li>
    <li><a class="reference internal" href="#ldap" id="id35">LDAP</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#email" id="id36">Email</a><ul>
    <li><a class="reference internal" href="#smtp-host" id="id37">SMTP_HOST</a></li>
    <li><a class="reference internal" href="#smtp-port" id="id38">SMTP_PORT</a></li>
    <li><a class="reference internal" href="#smtp-tls" id="id39">SMTP_TLS</a></li>
    <li><a class="reference internal" href="#smtp-username" id="id40">SMTP_USERNAME</a></li>
    <li><a class="reference internal" href="#smtp-password" id="id41">SMTP_PASSWORD</a></li>
    <li><a class="reference internal" href="#use-ses" id="id42">USE_SES</a></li>
    <li><a class="reference internal" href="#return-address" id="id43">RETURN_ADDRESS</a></li>
    <li><a class="reference internal" href="#require-email-validation" id="id44">require_email_validation</a></li>
    </ul>
    </li>
    <li><a class="reference internal" href="#advanced" id="id45">Advanced</a><ul>
    <li><a class="reference internal" href="#parcels-root" id="id46">PARCELS_ROOT</a></li>
    <li><a class="reference internal" href="#parcel-distro-suffixes" id="id47">PARCEL_DISTRO_SUFFIXES</a></li>
    <li><a class="reference internal" href="#default-channels" id="id48">DEFAULT_CHANNELS</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>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: 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="package-bucket-id">
    <h3><a class="toc-backref" href="#id16">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>
    <div class="section" id="web-server">
    <h2><a class="toc-backref" href="#id17">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="#id18">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="#id19">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="#id20">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="#id21">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="#id22">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="#id23">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="#id24">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="#id25">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="#id26">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="#id27">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="#id28">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 30.</p>
    </div>
    <div class="section" id="workers">
    <h4><a class="toc-backref" href="#id29">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="#id30">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="#id31">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="#id32">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="#id33">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="#id34">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="#id35">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>
    </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>
    <div class="section" id="email">
    <h2><a class="toc-backref" href="#id36">Email</a><a class="headerlink" href="#email" title="Permalink to this headline">¶</a></h2>
    <p>Anaconda Repository can be configured to send email after launching kapsels. 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="#id37">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="#id38">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="#id39">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="#id40">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="#id41">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="#id42">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="#id43">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="require-email-validation">
    <h3><a class="toc-backref" href="#id44">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="#id45">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="#id46">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="#id47">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">'squeeze',</span> <span class="pre">'sles11']</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="#id48">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>
