> ## 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. # Cómo Alojar Aplicaciones FastAPI > Aprende a crear y alojar aplicaciones FastAPI en 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 = "una aplicación FastAPI" ## Introducción Para desarrollar y alojar {appType_0} en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción. ### Requisitos previos * **Cuenta de Square Cloud**: Regístrate a través de la [página de registro](https://squarecloud.app/es/signup) usando tu correo electrónico. * **Plan de pago activo**: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros [planes disponibles](https://squarecloud.app/es/pricing) y elige el más adecuado para tus necesidades. ## Creando el proyecto Para crear una aplicación FastAPI, necesitas tener Python y pip instalados en tu sistema antes de seguir los pasos. ### Instalando la biblioteca Con Python y pip instalados, crea tu proyecto FastAPI. Primero, instala las dependencias necesarias: ```bash Terminal theme={null} pip install fastapi uvicorn ``` ### Desarrollando el proyecto Crea un archivo Python (por ejemplo, `main.py`) y añade el siguiente código para implementar una aplicación FastAPI básica: ```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) ``` En el código anterior, implementamos una ruta simple que devuelve "Hello, World!" cuando se accede a ella. La aplicación está configurada para ejecutarse en el puerto 80, que es el puerto HTTP predeterminado. A continuación, necesitamos crear nuestro archivo de dependencias. En Python tenemos requirements.txt o un pyproject.toml ## Eligiendo un servidor de producción Uvicorn ya es un servidor ASGI adecuado para producción, por lo que no se requiere un servidor WSGI adicional. En Square Cloud, en lugar de ejecutar `python main.py`, configura el campo `START` en tu archivo de configuración para iniciar Uvicorn directamente: ```systemd squarecloud.config theme={null} START=python -m uvicorn main:app --host 0.0.0.0 --port 80 ``` Para aplicaciones con mayor tráfico, puedes agregar workers adicionales de Uvicorn, por ejemplo `START=python -m uvicorn main:app --host 0.0.0.0 --port 80 --workers 4`. ## Desplegando Después de preparar los archivos de tu proyecto, ya puedes subirlos a Square Cloud y alojar tu proyecto. Para hacerlo, crea un archivo ZIP que contenga todos los archivos de tu proyecto. ### A través del panel Accede a la [página de subida](https://squarecloud.app/es/dashboard/new) y sube el archivo zip de tu proyecto. Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.\ Si estás subiendo un proyecto web, asegúrate de seleccionar "Publicación Web" y de definir un subdominio para tu proyecto. Por último, haz clic en el botón "Deploy" para alojar tu proyecto en Square Cloud.\ Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel. Subiendo aplicación a Square Cloud Tu primer despliegue suele tardar menos de un minuto. En el [dashboard](https://squarecloud.app/es/dashboard), espera a que el estado de tu aplicación muestre "running" y revisa los logs por si hay errores de inicio.\ Si desplegaste un sitio web o una API, abre `https://.squareweb.app` en tu navegador — deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online. ¿La aplicación no inicia? Consulta la [guía de solución de problemas](/es/platform/troubleshooting/app-wont-start) para ver las causas y soluciones más comunes. ### A través de la CLI Para usar este método, necesitas crear un archivo de configuración llamado `squarecloud.app` en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto. Aprende a crear el archivo de configuración `squarecloud.app` que define el entorno de tu aplicación. Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal: ``` npm install -g @squarecloud/cli ``` Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal: ```bash theme={null} squarecloud update ``` ```bash theme={null} curl -fsSL https://cli.squarecloud.app/install | bash ``` Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización [aquí](https://squarecloud.app/es/account/security) haciendo clic en "Request API Key". Después de obtener tu clave de autorización, ejecuta el siguiente comando: ```bash theme={null} squarecloud auth login ``` Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando: ```bash theme={null} squarecloud upload ``` O si creaste el zip manualmente, puedes usar: ```bash theme={null} squarecloud upload --file ``` Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal: ```bash theme={null} squarecloud app status squarecloud app logs ``` Si desplegaste un sitio web o una API, abre `https://.squareweb.app` en tu navegador — deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online. ¿La aplicación no inicia? Consulta la [guía de solución de problemas](/es/platform/troubleshooting/app-wont-start) para ver las causas y soluciones más comunes. ## Solución de problemas ### Dominio personalizado Para usar un dominio personalizado (por ejemplo, `mysite.com`) en lugar de la URL predeterminada `mysite.squareweb.app`, necesitas el **plan Standard o superior**. El subdominio se define mediante el campo **SUBDOMAIN** en el archivo de configuración. ### Requisitos mínimos de RAM **Mínimo: 512MB de RAM** para sitios web/APIs sencillos. Para sitios con frameworks (Next.JS, React, Vue, Angular, etc.), siempre recomendamos **al menos 1GB de RAM**. Para aplicaciones más grandes, asigna más RAM para evitar que la aplicación se quede sin memoria y falle. ### No se pudo encontrar este sitio. Verifica que el **subdominio/dominio** coincida con lo configurado en el campo **SUBDOMAIN** o en la **configuración del dominio personalizado**. Si acabas de subir el sitio, espera hasta **60 segundos** para que Square habilite el **primer acceso**. ### El sitio tardó demasiado en responder... Verifica que hayas configurado correctamente el **puerto 80** y el **host 0.0.0.0** en la aplicación. Recomendamos usar las variables de entorno forzadas de Square: **PORT** y **HOST** del archivo `.env`. ## Recursos adicionales Para información más detallada sobre FastAPI y sus herramientas avanzadas, visita la [documentación oficial de FastAPI](https://fastapi.tiangolo.com/). Allí encontrarás guías técnicas en profundidad, tutoriales especializados y documentación completa de la API para aprovechar al máximo las funcionalidades de FastAPI. ## Contáctanos Si continúas enfrentando **dificultades técnicas**, nuestro **equipo de soporte especializado** está disponible para ayudarte. [**Contáctanos**](https://squarecloud.app/es/support) y estaremos encantados de ayudarte a resolver cualquier problema — la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con [**4.9/5 en 402 reseñas**](https://www.trustpilot.com/review/squarecloud.app) en Google y Trustpilot.