Skip to content

Commit a2cf217

Browse files
Try and appease the dog 🐶
1 parent 0f2aeaf commit a2cf217

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

15/umbraco-cms/fundamentals/setup/server-setup/running-umbraco-in-docker.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,40 @@
11
# Running Umbraco in Docker
22

3-
Exactly how you choose to compose your Dockerfile depends on your needs, and your project, so this section is not intended as a guide,
3+
Exactly how you choose to compose your Dockerfile depends on your needs, and your project. This section is not intended as a guide,
44
but as a general overview of what to be aware of when hosting in Docker.
55

66
## What is Docker
77

8-
Docker is a platform for developing, shipping, and running applications in containers. There exist various services for hosting these containers,
8+
Docker is a platform for developing, shipping, and running applications in containers. There exist multiple services for hosting these containers,
99
for more information, [refer to the official Docker documentation](https://docs.docker.com/)
1010

1111
## The Docker file system
1212

13-
By default, all files created inside a container is written to a ephemeral writable container layer.
14-
This means that the files don't persist when the container is removed, and it's difficult to get files out of the container. Additionally, this writable layer is not suitable for performance-critical data processing.
15-
This has several implications when running Umbraco in Docker. For more information, refer to the [Docker documentation on storage](https://docs.docker.com/engine/storage/).
13+
By default, all files created inside a container are written to an ephemeral writable container layer.
14+
This means that the files don't persist when the container is removed, and it's challenging to get files out of the container. Additionally, this writable layer is not suitable for performance-critical data processing.
15+
This has implications when running Umbraco in Docker. For more information, refer to the [Docker documentation on storage](https://docs.docker.com/engine/storage/).
1616

1717
### General file system consideration
1818

19-
In general, when working with files and Dockcer you work in a "push" fashion with the read-only layers, that is when you build you take all your files and "push" them into the read-only layer.
20-
This means that you should avoid making files on the fly, and instead rely on building your image, this means that you should not create or edit template files on the fly, the same goes for script and style files.
19+
In general, when working with files and Docker you work in a "push" fashion with the read-only layers. WWhen you build, you take all your files and "push" them into the read-only layer.
20+
This means that you should avoid making files on the fly, and instead rely on building your image. You should not create or edit template files on the fly, the same goes for script and style files.
2121

22-
Similarly, you shouldn't use InMemory modelsbuilder, since that also relies on creating files on the disk. While this is not a hard requirement, it simply doesn't provide any value if not live editing your site, instead you should use source code in development, and none in production, as [described when using runtime modes](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/server-setup/runtime-modes).
22+
Similarly, you shouldn't use InMemory modelsbuilder, since that also relies on creating files on the disk. While this is not a hard requirement, it doesn't provide any value if not live editing your site. Instead, use source code in development, and none in production, as [described when using runtime modes](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/server-setup/runtime-modes).
2323

2424

2525
### Logs
2626

27-
Umbraco writes logs to the `/umbraco/Logs/` directory, due to the performance implications of writing to a writable layer,
27+
Umbraco writes logs to the `/umbraco/Logs/` directory. Due to the performance implications of writing to a writable layer,
2828
and the limited size of the writable layer, it is recommended to mount a volume to this directory.
2929

3030
### Data
3131

32-
The `/umbraco/Data/` directory is used to store temporary files, such as file uploads, considering the limitations of the writable layer, you should also mount a volume to this directory.
32+
The `/umbraco/Data/` directory is used to store temporary files, such as file uploads. Considering the limitations of the writable layer, you should also mount a volume to this directory.
3333

3434
### Media
3535

3636
Similarly to logs, it's recommended to not store media in the writable layer, both for performance reasons,
37-
but also for practical development reason, you likely want to persist media files between containers.
37+
but also for practical development reasons. You likely want to persist media files between containers.
3838

3939
One possible solution here is to again use bind mounts, however the ideal solution is store the media and ImageSharp cache externally,
4040
for more information on this, refer to the [Azure Blob Storage documentation](https://docs.umbraco.com/umbraco-cms/extending/filesystemproviders/azure-blob-storage).

0 commit comments

Comments
 (0)