Skip to content

Commit 984cb27

Browse files
committed
dbeaver/tech-docs#1295 installation with Docker image
1 parent 3cbfade commit 984cb27

1 file changed

Lines changed: 43 additions & 5 deletions

File tree

README.md

Lines changed: 43 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# CloudBeaver Enterprise deployment
22

3-
### Version 25.2
3+
## Version 25.2
44

55
CloudBeaver Enterprise is a client-server application.
66
It requires server deployment. You can deploy it on a single host (e.g. your local computer) or in a cloud.
@@ -10,7 +10,7 @@ It requires server deployment. You can deploy it on a single host (e.g. your loc
1010
It is the simplest way to install [CloudBeaver Enterprise Edition](https://dbeaver.com/cloudbeaver-enterprise/).
1111
All you need is a Linux, macOS, or Windows machine with Docker.
1212

13-
CloudBeaver can be run in a [single docker container](https://dbeaver.com/docs/cloudbeaver/CloudBeaver-Enterprise-deployment-from-docker-image/).
13+
CloudBeaver can be run in a [single docker container](#installation-with-docker-image).
1414
However you can use Docker compose for easy web server (HTTPS) configuration.
1515

1616
### System requirements
@@ -85,12 +85,12 @@ There are two ways to configure SSL:
8585

8686
### Podman requirements
8787

88-
as user `root` run following commands before [Configuring and starting the CloudBeaver cluster](#configuring-and-starting-team-edition-cluster):
88+
as user `root` run following commands before [Configuring and starting the CloudBeaver cluster](#configuring-and-starting-the-cloudbeaver-cluster):
8989
1. ```loginctl enable-linger 1000```
9090
2. ```echo 'net.ipv4.ip_unprivileged_port_start=80' >> /etc/sysctl.conf```
9191
3. ```sysctl -p```
9292

93-
on step 4 of [Configuring and starting the CloudBeaver cluster](#configuring-and-starting-team-edition-cluster) use `podman-compose` tool intead of `docker-compose` and on step 4 define compose file name:
93+
on step 4 of [Configuring and starting the CloudBeaver cluster](#configuring-and-starting-the-cloudbeaver-cluster) use `podman-compose` tool intead of `docker-compose` and on step 4 define compose file name:
9494
```
9595
podman-compose -f podman-compose.yml up -d
9696
```
@@ -101,11 +101,49 @@ or replace `docker-compose.yml` with `podman-compose.yml` and use `podman-compos
101101
2. Pull new docker images: `docker-compose pull` or `docker compose pull`
102102
3. Restart the cluster: `docker-compose up -d` or `docker compose up -d`
103103

104+
## Installation with Docker image
105+
106+
CloudBeaver Enterprise can run as a single Docker container:
107+
108+
1. Pull Docker image
109+
110+
```sh
111+
docker pull dbeaver/cloudbeaver-ee:latest
112+
```
113+
114+
> You can replace `latest` with a preferred [version tag](https://hub.docker.com/r/dbeaver/cloudbeaver-ee/tags).
115+
> Use the same tag when running the container.
116+
117+
2. Run container
118+
119+
```sh
120+
docker run --name cloudbeaver-ee --rm -ti -p 8978:8978 \
121+
-v /var/cloudbeaver-ee/workspace:/opt/cloudbeaver/workspace \
122+
dbeaver/cloudbeaver-ee:latest
123+
```
124+
125+
> Replace 8978 with a preferred host port.
126+
127+
3. Access application
128+
129+
Open `http://<server-ip>:8978` in a web browser.
130+
131+
### Configuring proxy server
132+
133+
Use the official CloudBeaver web proxy for proper HTTPS configuration.
134+
135+
You can choose between [Nginx](https://hub.docker.com/r/dbeaver/cloudbeaver-nginx/tags)
136+
and [HAProxy](https://hub.docker.com/r/dbeaver/cloudbeaver-haproxy/tags) images,
137+
or set up web proxy automatically with the [Docker Compose deployment](#installation-with-docker-compose).
138+
139+
> **Note**: The [Domain Manager](https://dbeaver.com/docs/cloudbeaver/Domain-Manager/) is available only when running
140+
> with a CloudBeaver web proxy setup.
141+
104142
## Kubernetes/Helm Deployment
105143

106144
For Kubernetes deployments using Helm charts, see:
107145
- [General Kubernetes/Helm deployment guide](k8s/README.md)
108-
- [AWS EKS specific deployment guide](AWS/aws-eks/eks-deployment.md)
146+
- [AWS EKS specific deployment guide](AWS/aws-eks/README.md)
109147

110148
### Older versions:
111149
- [25.1.0](https://github.com/dbeaver/cloudbeaver-deploy/tree/25.1.0)

0 commit comments

Comments
 (0)