Containers are in beta. Contact support to enable them for your server.
This page lists the limits that apply to container sites, and the features they don’t support.

Configuration limits

Volume paths

The folder in site home must be a relative path inside your home directory. It can’t be absolute, contain .., be the home directory itself, contain : or ,, or follow a symlink outside your home directory. The path in container must be absolute. It can’t be /, contain .., contain : or ,, or be under /proc, /sys or /dev. Volumes are always mounted read-write. Named volumes, read-only mounts and other mount options aren’t supported.

Networking

  • Only the web service receives traffic, over HTTP or WebSockets. Nginx terminates SSL on port 443 and forwards requests to the container with X-Forwarded-Proto, X-Forwarded-For and X-Real-IP headers.
  • Requests time out after 600 seconds.
  • UDP and other TCP ports can’t be published.
  • Containers can make outbound connections, subject to the server’s firewall.
If your application redirects to HTTPS, make sure it trusts the X-Forwarded-Proto header, otherwise it may redirect in a loop. For example, in Laravel, configure trusted proxies.

Disk usage

Images, volumes and any files written by your containers are stored in your site’s home directory and count towards its disk usage, including files owned by container users. Before pulling an image, Cito checks that the server has enough free disk space for it. If it doesn’t, the save is refused with an error showing how much space the image needs. Images that are no longer used are removed automatically after each update and periodically in the background.

Unsupported features

The following aren’t supported on container sites:
  • Building images from source. Build and push your image to a registry first, e.g. with GitHub Actions.
  • Images without a linux/amd64 build, e.g. ARM-only images.
  • Overriding the image’s entrypoint. Only the command can be overridden.
  • Health checks.
  • Setting the working directory or user. Set these in your image.
  • Privileged containers, extra capabilities, devices and host networking.
  • Registry credentials for services other than web.
  • Cloning the site.
  • Caching with Cito Boost.
  • Migrating a cPanel site to a container site.
  • Changing the internal port Nginx proxies to.