> ## Documentation Index > Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt > Use this file to discover all available pages before exploring further. # Come ospitare applicazioni FastAPI > Scopri come creare e ospitare applicazioni FastAPI su Square Cloud. export const PortNote = ({lang}) => { const t = { 'en': { q: 'What port should I use for my server?', a1: <>You should use port 80 for your server. Port 80 is the default port for HTTP traffic, which is handled by Square Cloud to route it to 443, HTTPS, for a secure connection., a2: 'Make sure to configure it before compressing and uploading your project.' }, 'pt-br': { q: 'Qual porta devo usar para o meu servidor?', a1: <>Você deve usar a porta 80 para o seu servidor. A porta 80 é a porta padrão para tráfego HTTP; a Square Cloud a encaminha para 443 (HTTPS) para estabelecer uma conexão segura., a2: 'Certifique-se de configurá-la antes de compactar e enviar seu projeto.' }, 'es': { q: '¿Qué puerto debo usar para mi servidor?', a1: <>Debes usar el puerto 80 para tu servidor. El puerto 80 es el puerto predeterminado para el tráfico HTTP; Square Cloud lo redirige al 443 (HTTPS) para establecer una conexión segura., a2: 'Asegúrate de configurarlo antes de comprimir y subir tu proyecto.' }, 'fr': { q: 'Quel port dois-je utiliser pour mon serveur ?', a1: <>Vous devez utiliser le port 80 pour votre serveur. Le port 80 est le port par défaut du trafic HTTP ; Square Cloud le redirige vers le port 443 (HTTPS) pour établir une connexion sécurisée., a2: "Assurez-vous de le configurer avant de compresser et d'envoyer votre projet." }, 'de': { q: 'Welchen Port sollte ich für meinen Server verwenden?', a1: <>Verwenden Sie Port 80 für Ihren Server. Port 80 ist der Standardport für HTTP-Traffic; Square Cloud leitet ihn für eine sichere Verbindung an Port 443 (HTTPS) weiter., a2: 'Stellen Sie sicher, dass Sie ihn konfigurieren, bevor Sie Ihr Projekt komprimieren und hochladen.' }, 'it': { q: 'Quale porta devo usare per il mio server?', a1: <>Devi usare la porta 80 per il tuo server. La porta 80 è la porta predefinita per il traffico HTTP; Square Cloud la instrada verso la 443 (HTTPS) per stabilire una connessione sicura., a2: 'Assicurati di configurarla prima di comprimere e caricare il tuo progetto.' }, 'ja': { q: 'サーバーにはどのポートを使えばよいですか？', a1: <>サーバーにはポート80を使用してください。ポート80はHTTPトラフィックのデフォルトポートで、Square Cloudが安全な接続のために443（HTTPS）へルーティングします。, a2: 'プロジェクトを圧縮してアップロードする前に、必ず設定してください。' }, 'zh': { q: '我的服务器应该使用哪个端口？', a1: <>您的服务器应使用端口 80。端口 80 是 HTTP 流量的默认端口，Square Cloud 会将其路由到 443（HTTPS）以建立安全连接。, a2: '请务必在压缩并上传项目之前完成配置。' } }; const c = t[lang] || t['en']; return {c.q}
{c.a1}
{c.a2} ; }; export const PyDepFiles = ({lang}) => { const desc = { "en": { requirements: "Standard file used in Python projects to list all the external libraries and dependencies that your project needs. Each line in this file specifies a package to be installed using pip, the Python package manager.", pyproject: "A modern configuration file for Python projects that can specify build system requirements and project metadata. It is used by tools like Poetry to manage dependencies and packaging." }, "pt-br": { requirements: "Arquivo padrão usado em projetos Python para listar todas as bibliotecas externas e dependências necessárias para o seu projeto. Cada linha neste arquivo especifica um pacote a ser instalado usando o pip, o gerenciador de pacotes do Python", pyproject: "Um arquivo de configuração moderno para projetos Python que permite especificar requisitos do sistema de compilação e metadados do projeto. É utilizado por ferramentas como o Poetry para gerenciar dependências e empacotamento." }, "es": { requirements: "Archivo estándar usado en proyectos Python para listar todas las bibliotecas externas y dependencias que tu proyecto necesita. Cada línea de este archivo especifica un paquete que se instalará usando pip, el gestor de paquetes de Python.", pyproject: "Un archivo de configuración moderno para proyectos Python que permite especificar los requisitos del sistema de compilación y los metadatos del proyecto. Lo utilizan herramientas como Poetry para gestionar dependencias y empaquetado." }, "fr": { requirements: "Fichier standard utilisé dans les projets Python pour lister toutes les bibliothèques externes et dépendances nécessaires à votre projet. Chaque ligne de ce fichier spécifie un paquet à installer avec pip, le gestionnaire de paquets de Python.", pyproject: "Un fichier de configuration moderne pour les projets Python qui permet de spécifier les exigences du système de build et les métadonnées du projet. Il est utilisé par des outils comme Poetry pour gérer les dépendances et le packaging." }, "de": { requirements: "Standarddatei in Python-Projekten, die alle externen Bibliotheken und Abhängigkeiten Ihres Projekts auflistet. Jede Zeile dieser Datei gibt ein Paket an, das mit pip, dem Paketmanager von Python, installiert wird.", pyproject: "Eine moderne Konfigurationsdatei für Python-Projekte, die Build-System-Anforderungen und Projektmetadaten festlegen kann. Sie wird von Tools wie Poetry zur Verwaltung von Abhängigkeiten und Packaging verwendet." }, "it": { requirements: "File standard usato nei progetti Python per elencare tutte le librerie esterne e le dipendenze necessarie al tuo progetto. Ogni riga di questo file specifica un pacchetto da installare con pip, il gestore di pacchetti di Python.", pyproject: "Un file di configurazione moderno per i progetti Python che consente di specificare i requisiti del sistema di build e i metadati del progetto. È utilizzato da strumenti come Poetry per gestire dipendenze e packaging." }, "ja": { requirements: "Python プロジェクトで、必要な外部ライブラリと依存関係をすべて列挙するための標準ファイルです。このファイルの各行は、Python のパッケージマネージャーである pip でインストールするパッケージを指定します。", pyproject: "ビルドシステムの要件やプロジェクトのメタデータを指定できる、Python プロジェクト向けのモダンな設定ファイルです。Poetry などのツールが依存関係とパッケージングの管理に使用します。" }, "zh": { requirements: "Python 项目中用于列出项目所需的所有外部库和依赖项的标准文件。文件中的每一行指定一个通过 pip（Python 的包管理器）安装的包。", pyproject: "Python 项目的现代配置文件，可指定构建系统要求和项目元数据。Poetry 等工具使用它来管理依赖项和打包。" } }; const d = desc[lang] || desc.en; return {d.requirements} {d.pyproject} ; }; export const RecommendedPlan = ({lang, plan, tier, cpu, appType}) => { const siteLang = lang === 'pt-br' ? 'pt-br' : 'en'; const url = `https://squarecloud.app/${siteLang}/pay?plan=${plan.toLowerCase()}&tier=${tier}`; const proUrl = `https://squarecloud.app/${siteLang}/pay?plan=pro`; const notes = { 'en': Wondering how much RAM and CPU your plan needs to host {appType}?
Don't worry, we're here to help. Our {plan} plan offers {tier}GB of RAM and {cpu}vCPU, which should be sufficient for most {appType}. However, if you are working on a larger project and seeking extra stability, we recommend considering our Pro plan. With additional resources, you can maintain stability even during demand spikes. To purchase, simply click here. , 'pt-br': Está se perguntando quanta RAM e CPU seu plano precisa para hospedar {appType}?
Não se preocupe, estamos aqui para ajudar. Nosso plano {plan} oferece {tier}GB de RAM e {cpu}vCPU, o que deve ser suficiente para a maioria dos {appType}. No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda. Para comprar, basta clicar aqui. , 'es': ¿Te preguntas cuánta RAM y CPU necesita tu plan para alojar {appType}?
No te preocupes, estamos aquí para ayudarte. Nuestro plan {plan} ofrece {tier}GB de RAM y {cpu}vCPU, lo que debería ser suficiente para la mayoría de {appType}. Sin embargo, si estás trabajando en un proyecto más grande y buscas mayor estabilidad, te recomendamos considerar nuestro plan Pro. Con recursos adicionales, puedes mantener la estabilidad incluso durante picos de demanda. Para comprarlo, simplemente haz clic aquí. , 'fr': Vous vous demandez combien de RAM et de CPU votre plan doit offrir pour héberger {appType} ?
Pas d'inquiétude, nous sommes là pour vous aider. Notre plan {plan} offre {tier} Go de RAM et {cpu} vCPU, ce qui devrait suffire pour la plupart des {appType}. Cependant, si vous travaillez sur un projet plus important et recherchez une stabilité accrue, nous vous recommandons notre plan Pro. Avec des ressources supplémentaires, vous conservez la stabilité même lors des pics de demande. Pour l'acheter, cliquez simplement ici. , 'de': Sie fragen sich, wie viel RAM und CPU Ihr Plan zum Hosten von {appType} benötigt?
Keine Sorge, wir helfen Ihnen gerne. Unser {plan}-Plan bietet {tier} GB RAM und {cpu} vCPU, was für die meisten {appType} ausreichen sollte. Wenn Sie jedoch an einem größeren Projekt arbeiten und zusätzliche Stabilität benötigen, empfehlen wir unseren Pro-Plan. Mit zusätzlichen Ressourcen bleibt Ihre Anwendung auch bei Lastspitzen stabil. Zum Kauf klicken Sie einfach hier. , 'it': Ti stai chiedendo quanta RAM e CPU serve al tuo piano per ospitare {appType}?
Non preoccuparti, siamo qui per aiutarti. Il nostro piano {plan} offre {tier}GB di RAM e {cpu}vCPU, che dovrebbero essere sufficienti per la maggior parte di {appType}. Tuttavia, se stai lavorando a un progetto più grande e cerchi maggiore stabilità, ti consigliamo il nostro piano Pro. Con risorse aggiuntive puoi mantenere la stabilità anche durante i picchi di richieste. Per acquistarlo, fai clic qui. , 'ja': {appType}のホスティングに必要なRAMとCPUの容量が気になりますか？
ご安心ください。私たちがサポートします。 {plan}プランは{tier}GBのRAMと{cpu}vCPUを提供しており、ほとんどの{appType}には十分です。 より大規模なプロジェクトでさらなる安定性を求める場合は、Proプランをおすすめします。追加リソースにより、需要のピーク時でも安定性を維持できます。 ご購入はこちらをクリックしてください。 , 'zh': 想知道托管{appType}需要多少 RAM 和 CPU 吗？
别担心，我们来帮您。 我们的 {plan} 套餐提供 {tier}GB RAM 和 {cpu}vCPU，对大多数{appType}来说已经足够。 如果您的项目规模更大、需要更高的稳定性，我们推荐 Pro 套餐。借助额外资源，即使在需求高峰期也能保持稳定。 点击这里即可购买。 }; return notes[lang] || notes['en']; }; export const appType_0 = "un'applicazione FastAPI" ## Introduzione Per sviluppare e ospitare {appType_0} su Square Cloud, è essenziale seguire una sequenza strutturata di configurazioni e prerequisiti. Questa guida tecnica coprirà l'intero processo, dalla configurazione iniziale al deploy in produzione. ### Prerequisiti * **Account Square Cloud**: Registrati tramite la [pagina di registrazione](https://squarecloud.app/it/signup) usando la tua email. * **Piano a pagamento attivo**: Garantisce risorse dedicate e prestazioni ottimizzate per la tua applicazione. Consulta i nostri [piani disponibili](https://squarecloud.app/it/pricing) e scegli quello più adatto alle tue esigenze. ## Creazione del progetto Per creare un'applicazione FastAPI, devi avere Python e pip installati sul tuo sistema prima di seguire i passaggi. ### Installazione della libreria Con Python e pip installati, crea il tuo progetto FastAPI. Per prima cosa, installa le dipendenze richieste: ```bash Terminal theme={null} pip install fastapi uvicorn ``` ### Sviluppo del progetto Crea un file Python (ad esempio, `main.py`) e aggiungi il codice seguente per implementare un'applicazione FastAPI di base: ```python main.py theme={null} # Import the FastAPI class and the uvicorn ASGI server from fastapi import FastAPI import uvicorn # Create an instance of the FastAPI class app = FastAPI() # Define a route for the root URL (/) that returns 'Hello, World!' @app.get("/") def hello_world(): return {"message": "Hello, World!"} # Check if this script is being run directly (not imported as a module) if __name__ == "__main__": # Run the FastAPI application on host 0.0.0.0 (all available network interfaces) and port 80 uvicorn.run(app, host="0.0.0.0", port=80) ``` Nel codice sopra, implementiamo una semplice route che restituisce "Hello, World!" quando viene richiamata. L'applicazione è configurata per essere eseguita sulla porta 80, che è la porta HTTP predefinita. Successivamente, dobbiamo creare il nostro file delle dipendenze. In Python abbiamo requirements.txt oppure un pyproject.toml ## Scelta di un server di produzione Uvicorn è già un server ASGI adatto alla produzione, quindi non è richiesto alcun server WSGI aggiuntivo. Su Square Cloud, invece di eseguire `python main.py`, imposta il campo `START` nel tuo file di configurazione per avviare Uvicorn direttamente: ```systemd squarecloud.config theme={null} START=python -m uvicorn main:app --host 0.0.0.0 --port 80 ``` Per applicazioni con traffico più elevato, puoi aggiungere worker Uvicorn extra, ad esempio `START=python -m uvicorn main:app --host 0.0.0.0 --port 80 --workers 4`. ## Deploy Dopo aver preparato i file del tuo progetto, puoi caricarli su Square Cloud e ospitare il tuo progetto. Per farlo, crea un file ZIP contenente tutti i file del progetto. ### Tramite dashboard Accedi alla [pagina di upload](https://squarecloud.app/it/dashboard/new) e carica il file zip del tuo progetto. Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.\ Se stai caricando un progetto web, assicurati di selezionare "Web Publication" e di impostare un sottodominio per il tuo progetto. Infine, clicca sul pulsante "Deploy" per ospitare il tuo progetto su Square Cloud.\ Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard. Caricamento dell'applicazione su Square Cloud Il primo deploy richiede di solito meno di un minuto. Nella [dashboard](https://squarecloud.app/it/dashboard), attendi che lo stato della tua applicazione mostri "in esecuzione" e controlla i log per eventuali errori di avvio.\ Se hai fatto il deploy di un sito web o di un'API, apri `https://.squareweb.app` nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online. La tua app non si avvia? Consulta la [guida alla risoluzione dei problemi](/it/platform/troubleshooting/app-wont-start) per le cause più comuni e le relative soluzioni. ### Tramite CLI Per utilizzare questo metodo, devi creare un file di configurazione chiamato `squarecloud.app` nella directory principale del tuo progetto. Questo file conterrà la configurazione necessaria per il tuo progetto. Scopri come creare il file di configurazione `squarecloud.app` che definisce l'ambiente della tua applicazione. Per prima cosa, devi avere la CLI installata nel tuo ambiente. Se non la hai ancora, esegui il seguente comando nel tuo terminale: ``` npm install -g @squarecloud/cli ``` Se la hai già, ti consigliamo di aggiornarla. Per farlo, esegui il seguente comando nel tuo terminale: ```bash theme={null} squarecloud update ``` ```bash theme={null} curl -fsSL https://cli.squarecloud.app/install | bash ``` Ora, per autenticarti e utilizzare gli altri comandi della CLI, troverai la tua chiave di autorizzazione [qui](https://squarecloud.app/it/account/security) cliccando su "Request API Key". Dopo aver ottenuto la tua chiave di autorizzazione, esegui il seguente comando: ```bash theme={null} squarecloud auth login ``` Infine, per eseguire il deploy della tua applicazione su Square Cloud tramite la CLI, devi eseguire il seguente comando: ```bash theme={null} squarecloud upload ``` Oppure, se hai creato lo zip manualmente, puoi usare: ```bash theme={null} squarecloud upload --file ``` Il primo deploy richiede di solito meno di un minuto. Controlla lo stato e i log della tua applicazione direttamente dal terminale: ```bash theme={null} squarecloud app status squarecloud app logs ``` Se hai fatto il deploy di un sito web o di un'API, apri `https://.squareweb.app` nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online. La tua app non si avvia? Consulta la [guida alla risoluzione dei problemi](/it/platform/troubleshooting/app-wont-start) per le cause più comuni e le relative soluzioni. ## Risoluzione dei problemi ### Dominio personalizzato Per utilizzare un dominio personalizzato (ad esempio, `mysite.com`) invece dell'URL predefinito `mysite.squareweb.app`, hai bisogno del **piano Standard o superiore**. Il sottodominio è definito dal campo **SUBDOMAIN** nel file di configurazione. ### Requisiti minimi di RAM **Minimo: 512MB di RAM** per siti web/API semplici. Per siti con framework (Next.JS, React, Vue, Angular, ecc.), consigliamo sempre **almeno 1GB di RAM**. Per applicazioni più grandi, alloca più RAM per evitare che l'applicazione esaurisca la memoria e si arresti in modo anomalo. ### Impossibile trovare questo sito. Verifica che il **sottodominio/dominio** corrisponda a quanto configurato nel campo **SUBDOMAIN** o nelle **impostazioni del dominio personalizzato**. Se hai appena caricato il sito, attendi fino a **60 secondi** affinché Square abiliti il **primo accesso**. ### Il sito ha impiegato troppo tempo per rispondere... Verifica di aver configurato correttamente la **porta 80** e l'**host 0.0.0.0** nell'applicazione. Consigliamo di utilizzare le variabili d'ambiente forzate di Square: **PORT** e **HOST** dal file `.env`. ## Risorse aggiuntive Per informazioni più dettagliate su FastAPI e i suoi strumenti avanzati, visita la [documentazione ufficiale di FastAPI](https://fastapi.tiangolo.com/). Lì troverai guide tecniche approfondite, tutorial specializzati e la documentazione completa dell'API per sfruttare al meglio le funzionalità di FastAPI. ## Contattaci Se continui a riscontrare **difficoltà tecniche**, il nostro **team di supporto specializzato** è disponibile ad assisterti. [**Contattaci**](https://squarecloud.app/it/support) e saremo felici di aiutarti a risolvere qualsiasi problema — la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud [**4,9/5 su 402 recensioni**](https://www.trustpilot.com/review/squarecloud.app) su Google e Trustpilot.