@@ -13,7 +13,43 @@ You can install and run Coder using the official Docker images published on
1313
1414- 2 CPU cores and 4 GB memory free on your machine.
1515
16- ##Install Coder via` docker run `
16+ ##Installation Methods
17+
18+ <Tabs >
19+ <TabItem value =" docker-compose " label =" Docker Compose " default >
20+
21+ ###Install Coder via` docker compose `
22+
23+ Coder's publishes a
24+ [ docker compose example] ( https://github.com/coder/coder/blob/main/compose.yaml )
25+ which includes an PostgreSQL container and volume.
26+
27+ 1 . Make sure you have[ Docker Compose] ( https://docs.docker.com/compose/install/ )
28+ installed.
29+
30+ 1 . Download the
31+ [ ` docker-compose.yaml ` ] ( https://github.com/coder/coder/blob/main/compose.yaml )
32+ file.
33+
34+ 1 . Update` group_add: ` in` docker-compose.yaml ` with the` gid ` of` docker `
35+ group. You can get the` docker ` group` gid ` by running the below command:
36+
37+ ``` shell
38+ getent group docker| cut -d: -f3
39+ ```
40+
41+ 1 . Start Coder with` docker compose up `
42+
43+ 1 . Visit the web UI via the configured url.
44+
45+ 1 . Follow the on-screen instructions log in and create your first template and
46+ workspace
47+
48+ Coder configuration is defined via environment variables. Learn more about
49+ Coder's[ configuration options] ( ../admin/setup/index.md ) .
50+
51+ </TabItem >
52+ <TabItem value =" docker-run-builtin " label =" Docker Run (Built-in DB) " >
1753
1854###Built-in database (quick)
1955
@@ -31,6 +67,9 @@ docker run --rm -it \
3167 ghcr.io/coder/coder:latest
3268```
3369
70+ </TabItem >
71+ <TabItem value =" docker-run-external " label =" Docker Run (External DB) " >
72+
3473###External database (recommended)
3574
3675For production deployments, we recommend using an external PostgreSQL database
@@ -47,35 +86,8 @@ docker run --rm -it \
4786 ghcr.io/coder/coder:latest
4887```
4988
50- ##Install Coder via` docker compose `
51-
52- Coder's publishes a
53- [ docker compose example] ( https://github.com/coder/coder/blob/main/compose.yaml )
54- which includes an PostgreSQL container and volume.
55-
56- 1 . Make sure you have[ Docker Compose] ( https://docs.docker.com/compose/install/ )
57- installed.
58-
59- 1 . Download the
60- [ ` docker-compose.yaml ` ] ( https://github.com/coder/coder/blob/main/compose.yaml )
61- file.
62-
63- 1 . Update` group_add: ` in` docker-compose.yaml ` with the` gid ` of` docker `
64- group. You can get the` docker ` group` gid ` by running the below command:
65-
66- ``` shell
67- getent group docker| cut -d: -f3
68- ```
69-
70- 1 . Start Coder with` docker compose up `
71-
72- 1 . Visit the web UI via the configured url.
73-
74- 1 . Follow the on-screen instructions log in and create your first template and
75- workspace
76-
77- Coder configuration is defined via environment variables. Learn more about
78- Coder's[ configuration options] ( ../admin/setup/index.md ) .
89+ </TabItem >
90+ </Tabs >
7991
8092##Install the preview release
8193