Does Coze have a Docker version requirement for on-premises? Judging from public issues, the answer is basically "yes, and the old version is easy to step on". The most typical phenomenon is that when you execute 'make web', you directly report 'unknown shorthand flag: 'f' in -f', which is usually not because the Coze program itself is broken, but because your Docker/Compose version is too old to even recognize the command form currently used in the repository.
In the official repository, the 'web' target of 'Makefile' directly uses 'docker compose -f docker/docker-compose.yml --env-file... up -d' is written. That said, this startup process relies on the 'docker compose' command by default, rather than the old 'docker-compose' v1 habit.
Why old versions are easy to overturn
Because the gameplay of Docker in the 18.x era is already very different from the current Compose. You may still be using the old binary or the old plugin, but the repository's startup script is already organized with the new commands. Therefore, parameters such as '-f', '--profile', and 'up -d' will directly report errors in the old environment, which looks like "Coze is not compatible", but in fact it is a mismatch between the startup tools.
A relatively stable judgment method
- Run 'docker compose version' first to see if your environment recognizes the new command.
- If you can only use 'docker-compose version', it usually means that the environment is too old.
- If the command parameters of 'make web' are reported to be incorrect, upgrade Docker Engine and Compose plugins first.
The official README already positions the project as a local deployment solution launched by Docker Compose, so the most hassle-free idea is not to "bypass the repository script", but to upgrade the host environment to a state where it can directly run this set of commands. In this way, there will be a lot less subsequent troubleshooting.
One sentence conclusion
Coze on-premises deployment is not just a Docker that can run, at least it must be able to use 'docker compose' normally. If you're still on 18.x + compose v1, upgrade your environment first, and then talk about Coze.
