​

Installation

docker run --rm --init \
  --name bytebase \
  --publish 8080:8080 --pull always \
  --volume ~/.bytebase/data:/var/opt/bytebase \
  bytebase/bytebase:latest

​

Next Step

​

Troubleshooting

​

Docker Compatibility

• Architecture mismatch: The docker image only supports linux/amd64 and linux/arm64 architectures. If it doesn’t match your OS architecture, you may supply --platform linux/amd64 as a best effort.
• Outdated Docker version: Your Docker version is too old and doesn’t support manifest lists.

​

Air-gapped Environment

# Save the image to a tar file
docker save bytebase/bytebase:latest > bytebase-latest.tar

# Transfer the tar file to your target environment
# Then load it on the target system
docker load < bytebase-latest.tar

# Tag and push as described above
docker tag bytebase/bytebase:latest your-registry.acme.com/library/bytebase:latest
docker push your-registry.acme.com/library/bytebase:latest

​

Port Conflicts

​

Connect to Database on Same Host

• If you run Bytebase inside Docker on Linux, then you need to supply the additional --network host flags in docker run command. This allows Bytebase to connect to database instance running on the same host with localhost.
• If you run Bytebase inside Docker Desktop on Mac , then you need to use host.docker.internal to connect to database instance running on the same host.

​

Colima Support

mkdir ~/volumes
colima start --mount ~/volumes:w