Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sevalla.com/llms.txt

Use this file to discover all available pages before exploring further.

Below we’ve compiled the most common technical questions about Sevalla’s Application Hosting.

​
What kind of repository can I use with Application Hosting?

When you add an application in Sevalla you can use a public or private Git repository or Docker image. If you use a public Git repository, you need the URL and branch of the repository. Private Git repositories must be hosted on Bitbucket, GitHub, or GitLab. If you use a public Docker image you need the path to the Docker image. Private Docker images must be hosted on a GitHub (ghcr.io), GitLab (registry.gitlab.com), or Docker Hub (docker.io) registry. 

​
Can I save data to the file system?

Yes, if you add persistent storage, which adds a storage volume that retains data even if the application is restarted or redeployed.

​
Can I move or clone an application to a different region?

An application’s region (data center) is set when you add the application and can’t be changed in place. To run an application in a different region, clone it into the target region instead of recreating it by hand. The Sevalla API’s clone endpoint creates an identical copy of an existing application, including its processes, environment variables, build settings, and configuration, then triggers an initial deployment automatically. To clone into another region, send a POST request to /applications/{id}/clone with a display_name and the cluster_id of the target region: 
curl -X POST https://api.sevalla.com/v3/applications/{id}/clone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"display_name": "My App (europe-west1)", "cluster_id": "TARGET_CLUSTER_ID"}'
This is the easiest way to co-locate an application with its database, since internal connections are only supported between applications and databases in the same region. You can list the available regions and their cluster IDs with the /resources/clusters endpoint. For full details, see the API reference.
Persistent storage contents and the temporary .sevalla.app domain are not carried over to the clone. After the clone is deployed, set up the internal connection to your database and move any custom domains, then delete the original application.

​
Can I host (insert your preferred CMS or framework) with Sevalla’s Application Hosting?

There’s a good chance the answer is yes. If you’re not sure, feel free to give it a try! Our Support team will work with you to help with any bugs you encounter on our platform, though we cannot guarantee all applications will work.

​
Can applications send email?

Yes, if your application uses a service like SendGrid or Mailchimp to send emails through their API. Ports 25, 465, and 587 (standard SMTP ports) are blocked at Sevalla because we do not provide email hosting services.

​
Can I get a static external IP address to add my application to an allowlist with third-party services?

Because the IP address of your application may change/rotate with each deployment, it isn’t possible to provide a single specific outbound IP address. We recommend using a different authorization method (e.g. OAuth, a bastion server, etc.) to authenticate your application with your third-party service.

​
Can you specify the Python version and module version?

Yes, you can specify the Python version in your application’s runtime.txt file: 
python-3.10.6
The module version can be specified in the requirements.txt file: 
Django==3.2
virtualenv==20.18.0
For more examples in other languages, refer to specify a Language Version in Nixpacks or Buildpacks.

​
Can I run Composer?

Yes, you can use Composer to declare the libraries and dependencies your project needs, and Composer automatically handles downloading, installing, and updating those dependencies. You can define the required dependencies for your project in a composer.json file in your project’s root directory. For more information, check out our blog post on How to create your own Composer package.

​
Can I define PHP extensions?

Yes, you can specify the required PHP extensions in your composer.json file to ensure that the necessary extensions are installed and enabled for your application to work correctly. For example, if you want to use the Imagick extension from ImageMagick for image processing, you can add the following to composer.json: 
{
    "require": {
        "ext-imagick": "*"
    }
}