docs: add bulding container docs
This commit is contained in:
parent
34d261179e
commit
96221cc4f7
1 changed files with 32 additions and 0 deletions
32
docs/build-headscale-container.md
Normal file
32
docs/build-headscale-container.md
Normal file
|
@ -0,0 +1,32 @@
|
|||
# Build docker from scratch
|
||||
|
||||
The Dockerfiles included in the repository are using the [buildx plugin](https://docs.docker.com/buildx/working-with-buildx/). This plugin is includes in docker newer than Docker-ce CLI 19.03.2. The plugin is used to be able to build different container arches. Building the Dockerfiles without buildx is not possible.
|
||||
|
||||
# Build native
|
||||
|
||||
To build the container on the native arch you can just use:
|
||||
```
|
||||
$ sudo docker buildx build -t headscale:custom-arch .
|
||||
```
|
||||
|
||||
For example: This will build a amd64(x86_64) container if your hostsystem is amd64(x86_64). Or a arm64 container on a arm64 hostsystem (raspberry pi4).
|
||||
|
||||
# Build cross platform
|
||||
|
||||
To build a arm64 container on a amd64 hostsystem you could use:
|
||||
```
|
||||
$ sudo docker buildx build --platform linux/arm64 -t headscale:custom-arm64 .
|
||||
|
||||
```
|
||||
|
||||
**Import: Currently arm32 build are not supported as there is a problem with a library used by headscale. Hopefully this will be fixed soon.**
|
||||
|
||||
# Build multiple arches
|
||||
|
||||
To build multiple archres you could use:
|
||||
|
||||
```
|
||||
$ sudo docker buildx create --use
|
||||
$ sudo docker buildx build --platform linux/amd64,linux/arm64 .
|
||||
|
||||
```
|
Loading…
Reference in a new issue