<ahref="https://github.com/Steffo99/sophon/blob/main/thesis/source/6_installazione/4_configuring_compose.rst"class="fa fa-github"> Modifica su GitHub</a>
<h1><spanclass="section-number">1.4. </span>Configurazione <codeclass="docutils literal notranslate"><spanclass="pre">docker-compose.yml</span></code><aclass="headerlink"href="#configurazione-docker-compose-yml"title="Link a questa intestazione"></a></h1>
<p>Si configuri con l'editor di testo preferito il file <codeclass="docutils literal notranslate"><spanclass="pre">docker-compose.yml</span></code> con le impostazioni desiderate.</p>
<p>In particolare, tutte le impostazioni precedute da <codeclass="docutils literal notranslate"><spanclass="pre">#</span><spanclass="pre">INSTALL</span></code> vanno obbligatoriamente modificate.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_SECRET_KEY</span></span><aclass="headerlink"href="#envvar-DJANGO_SECRET_KEY"title="Link a questa definizione"></a></dt>
<dd><p>Specifica la chiave segreta da usare per i cookie di sessione.</p>
<p>Cambiare la chiave segreta una volta installato Sophon invaliderà tutti gli accessi effettuati dagli utenti.</p>
</div>
<divclass="admonition danger">
<pclass="admonition-title">Pericolo</p>
<p>La chiave segreta è un dato estremamente riservato: chiunque sia a conoscenza della chiave segreta potrà effettuare l'accesso come qualsiasi utente!</p>
</div>
<divclass="admonition seealso">
<pclass="admonition-title">Vedi anche</p>
<p><aclass="reference external"href="https://docs.djangoproject.com/en/3.2/ref/settings/#std:setting-SECRET_KEY">SECRET_KEY</a> nella documentazione di Django.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_PROXY_BASE_DOMAIN</span></span><aclass="headerlink"href="#envvar-DJANGO_PROXY_BASE_DOMAIN"title="Link a questa definizione"></a></dt>
<dd><p>Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il dominio per il quale si è configurato il DNS in precedenza.</p>
<p>Se non è specificato, Sophon verrà eseguito in <aclass="reference internal"href="../realizzazione/index.html#modalita-sviluppo"><spanclass="std std-ref">modalità sviluppo</span></a>.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_PROXY_PROTOCOL</span></span><aclass="headerlink"href="#envvar-DJANGO_PROXY_PROTOCOL"title="Link a questa definizione"></a></dt>
<dd><p>Specifica il protocollo che dovrà essere usato nei mapping del proxy.</p>
<p>Si consiglia di utilizzare <codeclass="docutils literal notranslate"><spanclass="pre">https</span></code>, ma è un valore valido anche <codeclass="docutils literal notranslate"><spanclass="pre">http</span></code>.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_ALLOWED_HOSTS</span></span><aclass="headerlink"href="#envvar-DJANGO_ALLOWED_HOSTS"title="Link a questa definizione"></a></dt>
<dd><p>Specifica i domini da cui possono provenire le richieste alla pagina di amministrazione.</p>
<p>Per specificare più domini, è necessario separarli con dei pipe <codeclass="docutils literal notranslate"><spanclass="pre">|</span></code> .</p>
<p>Eccetto in configurazioni speciali, deve essere uguale al dominio prefisso da <codeclass="docutils literal notranslate"><spanclass="pre">api.</span></code>.</p>
<p><aclass="reference external"href="https://docs.djangoproject.com/en/3.2/ref/settings/#allowed-hosts">ALLOWED_HOSTS</a> nella documentazione di Django.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_ALLOWED_ORIGINS</span></span><aclass="headerlink"href="#envvar-DJANGO_ALLOWED_ORIGINS"title="Link a questa definizione"></a></dt>
<dd><p>Specifica i domini da cui possono provenire le richieste all'API.</p>
<p>Per specificare più domini, è necessario separarli con dei pipe <codeclass="docutils literal notranslate"><spanclass="pre">|</span></code> .</p>
<p>Eccetto in configurazioni speciali, deve contenere il proprio dominio prefisso dal protocollo, e in aggiunta il dominio speciale <codeclass="docutils literal notranslate"><spanclass="pre">https://sophon.steffo.eu</span></code>, necessario per permettere l'accesso dall'interfaccia web "universale" di Sophon.</p>
<p>L'header <aclass="reference external"href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin">Access-Control-Allow-Origin</a> su MDN.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_STATIC_URL</span></span><aclass="headerlink"href="#envvar-DJANGO_STATIC_URL"title="Link a questa definizione"></a></dt>
<dd><p>Specifica l'URL a cui saranno accessibili i file statici di Sophon.</p>
<p>Eccetto in configurazioni speciali, deve essere uguale alla seguente stringa, con le parole in maiuscolo sostituite rispettivamente dal protocollo e dal dominio selezionato: <codeclass="docutils literal notranslate"><spanclass="pre">PROTOCOLLO://static.DOMINIO/django-static/</span></code>.</p>
<p>Ci si assicuri che sia presente uno slash al termine della stringa, oppure il pannello di amministrazione non sarà visualizzato correttamente!</p>
</div>
<divclass="admonition seealso">
<pclass="admonition-title">Vedi anche</p>
<p><aclass="reference external"href="https://docs.djangoproject.com/en/3.2/ref/settings/#std:setting-STATIC_URL">STATIC_URL</a> nella documentazione di Django</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_LANGUAGE_CODE</span></span><aclass="headerlink"href="#envvar-DJANGO_LANGUAGE_CODE"title="Link a questa definizione"></a></dt>
<dd><p>Specifica la lingua che deve usare Sophon nei messaggi di errore.</p>
<p>Usa il formato <aclass="reference external"href="https://docs.djangoproject.com/en/3.2/topics/i18n/#term-language-code">language code</a> di Django.</p>
<p><aclass="reference external"href="https://docs.djangoproject.com/en/3.2/ref/settings/#language-code">LANGUAGE_CODE</a> nella documentazione di Django</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_TIME_ZONE</span></span><aclass="headerlink"href="#envvar-DJANGO_TIME_ZONE"title="Link a questa definizione"></a></dt>
<dd><p>Specifica il fuso orario che deve usare Sophon nell'interfaccia di amministrazione.</p>
<p>Usa il formato <aclass="reference external"href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">tzdata</a>.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_SU_USERNAME</span></span><aclass="headerlink"href="#envvar-DJANGO_SU_USERNAME"title="Link a questa definizione"></a></dt>
<dd><p>Specifica il nome del <aclass="reference internal"href="../progetto/index.html#livelli-di-accesso"><spanclass="std std-ref">superutente</span></a> che verrà automaticamente creato qualora il database non contenga altri utenti.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_SU_EMAIL</span></span><aclass="headerlink"href="#envvar-DJANGO_SU_EMAIL"title="Link a questa definizione"></a></dt>
<dd><p>Specifica l'email del <aclass="reference internal"href="../progetto/index.html#livelli-di-accesso"><spanclass="std std-ref">superutente</span></a> che verrà automaticamente creato qualora il database non contenga altri utenti.</p>
<spanclass="sig-name descname"><spanclass="pre">DJANGO_SU_PASSWORD</span></span><aclass="headerlink"href="#envvar-DJANGO_SU_PASSWORD"title="Link a questa definizione"></a></dt>
<dd><p>Specifica la password del <aclass="reference internal"href="../progetto/index.html#livelli-di-accesso"><spanclass="std std-ref">superutente</span></a> che verrà automaticamente creato qualora il database non contenga altri utenti.</p>
<spanclass="sig-name descname"><spanclass="pre">REACT_APP_DEFAULT_INSTANCE</span></span><aclass="headerlink"href="#envvar-REACT_APP_DEFAULT_INSTANCE"title="Link a questa definizione"></a></dt>
<dd><p>Specifica il valore con cui precompilare il campo "selezione istanza" dell'interfaccia web di Sophon.</p>
<p>Eccetto in configurazioni speciali, deve essere uguale al dominio prefisso dal protocollo e da <codeclass="docutils literal notranslate"><spanclass="pre">api.</span></code>.</p>
<spanclass="sig-name descname"><spanclass="pre">APACHE_PROXY_BASE_DOMAIN</span></span><aclass="headerlink"href="#envvar-APACHE_PROXY_BASE_DOMAIN"title="Link a questa definizione"></a></dt>
<dd><p>Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il <codeclass="docutils literal notranslate"><spanclass="pre">DOMINIO</span></code> per il quale si è configurato il DNS in precedenza.</p>
<p>Deve essere uguale a <spanclass="target"id="index-0"></span><aclass="reference internal"href="#envvar-DJANGO_PROXY_BASE_DOMAIN"><codeclass="xref std std-envvar docutils literal notranslate"><spanclass="pre">DJANGO_PROXY_BASE_DOMAIN</span></code></a>.</p>
