Hi @iDschepe , weird as that's what I thought the --pull argument did!

So therefore, the way I now understand it is:

docker run --rm -p 8000:8000 surrealdb/surrealdb:latest start

will download the image if it doesn't exist and:

docker run --pull --rm -p 8000:8000 surrealdb/surrealdb:latest start

will update the image if it does exist but isn't the latest, but won't pull it initially if it doesn't exist?

Is this correct?

Hi @tobiemh, I agree, it is a bit confusing.

Yes, it is exactly like you wrote.

The very first time I used the command, I got the error mentioned in the PR.
So, I tried to delete the image and all containers and re-run your new command (without --pull option):

docker run --rm -p 8000:8000 surrealdb/surrealdb:latest start

AND it is starting up just fine, output:

Unable to find image 'surrealdb/surrealdb:latest' locally
latest: Pulling from surrealdb/surrealdb
...

Ok in that case, instead of adding the 'if you experience an error' section, could we change the initial command to just

docker run --rm -p 8000:8000 surrealdb/surrealdb:latest start

and then add a section below it to 'update the image to the latest version':

docker pull surrealdb/surrealdb

That way, the first command should always succeed!

Updated the PR as you suggested. Thanks!

Thanks @iDschepe for this commit 😀👏! And thanks for your input @sunero4!