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
webservice receives traffic, over HTTP or WebSockets. Nginx terminates SSL on port 443 and forwards requests to the container withX-Forwarded-Proto,X-Forwarded-ForandX-Real-IPheaders. - 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/amd64build, 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.
