2023-07-31 18:43:11 +00:00
<!doctype html> < html lang = en class = no-js > < head > < meta charset = utf-8 > < meta name = viewport content = "width=device-width,initial-scale=1" > < meta name = description content = "Welcome to the home of the LinuxServer.io documentation!" > < meta name = author content = LinuxServer.io > < link href = https://docs.linuxserver.io/general/updating-our-containers/ rel = canonical > < link href = ../understanding-puid-and-pgid/ rel = prev > < link href = ../volumes/ rel = next > < link rel = icon href = "https://gblobscdn.gitbook.com/spaces%2F-LWuIse8qFJj2MqDi90T%2Favatar-1590244439115.png?alt=media" > < meta name = generator content = "mkdocs-1.5.1, mkdocs-material-9.1.21" > < title > Updating our containers - LinuxServer.io< / title > < link rel = stylesheet href = ../../assets/stylesheets/main.eebd395e.min.css > < link rel = stylesheet href = ../../assets/stylesheets/palette.ecc896b0.min.css > < link rel = preconnect href = https://fonts.gstatic.com crossorigin > < link rel = stylesheet href = "https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback" > < style > : root { --md-text-font : "Roboto" ; --md-code-font : "Roboto Mono" } < / style > < script > _ _md _scope = new URL ( "../.." , location ) , _ _md _hash = e => [ ... e ] . reduce ( ( e , _ ) => ( e << 5 ) - e + _ . charCodeAt ( 0 ) , 0 ) , _ _md _get = ( e , _ = localStorage , t = _ _md _scope ) => JSON . parse ( _ . getItem ( t . pathname + "." + e ) ) , _ _md _set = ( e , _ , t = localStorage , a = _ _md _scope ) => { try { t . setItem ( a . pathname + "." + e , JSON . stringify ( _ ) ) } catch ( e ) { } } < / script > < / head > < body dir = ltr data-md-color-scheme = default data-md-color-primary = purple data-md-color-accent = indigo > < script > var palette = _ _md _get ( "__palette" ) ; if ( palette && "object" == typeof palette . color ) for ( var key of Object . keys ( palette . color ) ) document . body . setAttribute ( "data-md-color-" + key , palette . color [ key ] ) < / script > < input class = md-toggle data-md-toggle = drawer type = checkbox id = __drawer autocomplete = off > < input class = md-toggle data-md-toggle = search type = checkbox id = __search autocomplete = off > < label class = md-overlay for = __drawer > < / label > < div data-md-component = skip > < a href = #updating-our-containers class = md-skip > Skip to content < / a > < / div > < div data-md-component = announce > < / div > < header class = "md-header md-header--shadow" data-md-component = header > < nav class = "md-header__inner md-grid" aria-label = Header > < a href = ../.. title = LinuxServer.io class = "md-header__button md-logo" aria-label = LinuxServer.io data-md-component = logo > < img src = "https://gblobscdn.gitbook.com/spaces%2F-LWuIse8qFJj2MqDi90T%2Favatar-1590244439115.png?alt=media" alt = logo > < / a > < label class = "md-header__button md-icon" for = __drawer > < svg xmlns = http://www.w3.org/2000/svg viewbox = "0 0 24 24" > < path d = "M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z" / > < / svg > < / label > < div class = md-header__title data-md-component = header-title > < div class = md-header__ellipsis > < div class = md-header__topic > < span class = md-ellipsis > LinuxServer.io < / span > < / div > < div class = md-header__topic data-md-component = header-topic > < span class = md-ellipsis > Updating our containers < / span > < / div > < / div > < / div > < form class = md-header__option data-md-component = palette > < input class = md-option data-md-color-media = "(prefers-color-scheme: light)" data-md-color-scheme = default data-md-color-primary = purple data-md-color-accent = indigo aria-label = "Switch to dark mode" type = radio name = __palette id = __palette_1 > < label class = "md-header__button md-icon" title = "Switch to dark mode" for = __palette_2 hidden > < svg xmlns = http://www.w3.org/2000/svg viewbox = "0 0 24 24" > < path d = "M17 6H7c-3.31 0-6 2.69-6 6s2.69 6 6 6h10c3.31 0 6-2.69 6-6s-2.69-6-6-6zm0 10H7c-2.21 0-4-1.79-4-4s1.79-4 4-4h10c2.21 0 4 1.79 4 4s-1.79 4-4 4zM7 9c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z" / > < / svg > < / label > < input class = md-option data-md-color-media = "(prefers-color-scheme: dark)" data-md-color-scheme = slate data-md-color-primary = purple data-md-color-accent = indigo aria-label = "Switch to light mode" type = radio name = __palette id = __palette_2 > < label class = "md-header__button md-icon" title = "Switch to light mode" for = __palette_1 hidden > < svg xmlns = http://www.w3.org/2000/svg viewbox = "0 0 24 24" > < path d = "M17 7H7a5 5 0 0 0-5 5 5 5 0 0 0 5 5h10a5 5 0 0 0 5-5 5 5 0 0 0-
2023-01-08 13:57:31 +00:00
< / code > < / pre > < / div > < h3 id = remove-the-container > Remove the container< / h3 > < p > Once the container has been stopped, remove it.< / p > < blockquote > < p > < strong > Important< / strong > : Did you remember to persist the < code > /config< / code > volume when you originally created the container? Bear in mind, you'll lose any configuration inside the container if this volume was not persisted. < a href = ../volumes/ > Read up on why this is important< / a > .< / p > < / blockquote > < div class = highlight > < pre > < span > < / span > < code > docker< span class = w > < / span > rm< span class = w > < / span > < container_name>
< / code > < / pre > < / div > < h3 id = pull-the-latest-version > Pull the latest version< / h3 > < p > Now you can pull the latest version of the application image from Docker Hub.< / p > < div class = highlight > < pre > < span > < / span > < code > docker< span class = w > < / span > pull< span class = w > < / span > linuxserver/< image_name>
< / code > < / pre > < / div > < h3 id = recreate-the-container > Recreate the container< / h3 > < p > Finally, you can recreate the container. This is often cited as the most arduous task as it requires you to remember all of the mappings you set beforehand. You can help mitigate this step by using Docker Compose instead - this topic has been < a href = ../docker-compose/ > outlined in our documentation< / a > .< / p > < div class = highlight > < pre > < span > < / span > < code > docker< span class = w > < / span > create< span class = w > < / span > < span class = se > \< / span >
< span class = w > < / span > --name< span class = o > =< / span > < container_name> < span class = w > < / span > < span class = se > \< / span >
< span class = w > < / span > -v< span class = w > < / span > < path_to_data> :/config< span class = w > < / span > < span class = se > \< / span >
< span class = w > < / span > -e< span class = w > < / span > < span class = nv > PUID< / span > < span class = o > =< / span > < uid> < span class = w > < / span > < span class = se > \< / span >
< span class = w > < / span > -e< span class = w > < / span > < span class = nv > PGID< / span > < span class = o > =< / span > < gid> < span class = w > < / span > < span class = se > \< / span >
< span class = w > < / span > -p< span class = w > < / span > < host_port> :< app_port> < span class = w > < / span > < span class = se > \< / span >
< span class = w > < / span > linuxserver/< image_name>
< / code > < / pre > < / div > < h2 id = docker-compose > Docker Compose< / h2 > < p > It is also possible to update a single container using Docker Compose:< / p > < div class = highlight > < pre > < span > < / span > < code > docker-compose< span class = w > < / span > pull< span class = w > < / span > linuxserver/< image_name>
docker-compose< span class = w > < / span > up< span class = w > < / span > -d< span class = w > < / span > < container_name>
< / code > < / pre > < / div > < p > Or, to update all containers at once:< / p > < div class = highlight > < pre > < span > < / span > < code > docker-compose< span class = w > < / span > pull
docker-compose< span class = w > < / span > up< span class = w > < / span > -d
< / code > < / pre > < / div > < h2 id = removing-old-images > Removing old images< / h2 > < p > Whenever a Docker image is updated, a fresh version of that image gets downloaded and stored on your host machine. Doing this, however, does not remove the < em > old< / em > version of the image. Eventually you will end up with a lot of disk space used up by stale images. You can < code > prune< / code > old images from your system, which will free up space:< / p > < div class = highlight > < pre > < span > < / span > < code > docker< span class = w > < / span > image< span class = w > < / span > prune
2023-07-10 02:36:55 +00:00
< / code > < / pre > < / div > < / article > < / div > < / div > < / main > < footer class = md-footer > < div class = "md-footer-meta md-typeset" > < div class = "md-footer-meta__inner md-grid" > < div class = md-copyright > < div class = md-copyright__highlight > Copyright © 2022 LinuxServer.io < / div > Made with < a href = https://squidfunk.github.io/mkdocs-material/ target = _blank rel = noopener > Material for MkDocs < / a > < / div > < div class = md-social > < a href = https://github.com/linuxserver target = _blank rel = noopener title = github.com class = md-social__link > < svg xmlns = http://www.w3.org/2000/svg viewbox = "0 0 448 512" > <!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc. --> < path d = "M400 32H48C21.5 32 0 53.5 0 80v352c0 26.5 21.5 48 48 48h352c26.5 0 48-21.5 48-48V80c0-26.5-21.5-48-48-48zM277.3 415.7c-8.4 1.5-11.5-3.7-11.5-8 0-5.4.2-33 .2-55.3 0-15.6-5.2-25.5-11.3-30.7 37-4.1 76-9.2 76-73.1 0-18.2-6.5-27.3-17.1-39 1.7-4.3 7.4-22-1.7-45-13.9-4.3-45.7 17.9-45.7 17.9-13.2-3.7-27.5-5.6-41.6-5.6-14.1 0-28.4 1.9-41.6 5.6 0 0-31.8-22.2-45.7-17.9-9.1 22.9-3.5 40.6-1.7 45-10.6 11.7-15.6 20.8-15.6 39 0 63.6 37.3 69 74.3 73.1-4.8 4.3-9.1 11.7-10.6 22.3-9.5 4.3-33.8 11.7-48.3-13.9-9.1-15.8-25.5-17.1-25.5-17.1-16.2-.2-1.1 10.2-1.1 10.2 10.8 5 18.4 24.2 18.4 24.2 9.7 29.7 56.1 19.7 56.1 19.7 0 13.9.2 36.5.2 40.6 0 4.3-3 9.5-11.5 8-66-22.1-112.2-84.9-112.2-158.3 0-91.8 70.2-161.5 162-161.5S388 165.6 388 257.4c.1 73.4-44.7 136.3-110.7 158.3zm-98.1-61.1c-1.9.4-3.7-.4-3.9-1.7-.2-1.5 1.1-2.8 3-3.2 1.9-.2 3.7.6 3.9 1.9.3 1.3-1 2.6-3 3zm-9.5-.9c0 1.3-1.5 2.4-3.5 2.4-2.2.2-3.7-.9-3.7-2.4 0-1.3 1.5-2.4 3.5-2.4 1.9-.2 3.7.9 3.7 2.4zm-13.7-1.1c-.4 1.3-2.4 1.9-4.1 1.3-1.9-.4-3.2-1.9-2.8-3.2.4-1.3 2.4-1.9 4.1-1.5 2 .6 3.3 2.1 2.8 3.4zm-12.3-5.4c-.9 1.1-2.8.9-4.3-.6-1.5-1.3-1.9-3.2-.9-4.1.9-1.1 2.8-.9 4.3.6 1.3 1.3 1.8 3.3.9 4.1zm-9.1-9.1c-.9.6-2.6 0-3.7-1.5s-1.1-3.2 0-3.9c1.1-.9 2.8-.2 3.7 1.3 1.1 1.5 1.1 3.3 0 4.1zm-6.5-9.7c-.9.9-2.4.4-3.5-.6-1.1-1.3-1.3-2.8-.4-3.5.9-.9 2.4-.4 3.5.6 1.1 1.3 1.3 2.8.4 3.5zm-6.7-7.4c-.4.9-1.7 1.1-2.8.4-1.3-.6-1.9-1.7-1.5-2.6.4-.6 1.5-.9 2.8-.4 1.3.7 1.9 1.8 1.5 2.6z" / > < / svg > < / a > < a href = https://gitlab.com/linuxserver.io target = _blank rel = noopener title = gitlab.com class = md-social__link > < svg xmlns = http://www.w3.org/2000/svg viewbox = "0 0 448 512" > <!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc. --> < path d = "M48 32h352c26.5 0 48 21.5 48 48v352c0 26.5-21.5 48-48 48H48c-26.5 0-48-21.5-48-48V80c0-26.5 21.5-48 48-48zm334.1 192.9-44.6-116.4c-.9-2.3-2.6-4.3-4.6-5.6-1.6-1-3.4-1.6-5.2-1.8-1.8-.2-3.7.1-5.4.7-1.7.7-3.3 1.7-4.5 3.1-1.2 1.4-2.1 3-2.6 4.8L285 201.9H162.1l-29.2-92.2c-.5-1.8-1.5-3.4-2.7-4.8-2.1-1.3-2.8-2.4-4.5-3-2.6-.7-3.6-1.8-5.4-.8-1.8.2-3.6.8-5.2 1.8-2 1.3-3.6 3.3-4.5 5.6L65.94 224.9l-.47 1.2a82.94 82.94 0 0 0-2.25 52.5c4.96 17.3 15.4 32.5 29.75 43.3l.17.1.38.3 67.88 50.9 54.2 40.9c1.5 1 5.3 2.8 8.3 2.8 3 0 6-1.8 8.4-2.8l54.1-40.9 68.4-51.2.2-.1c14.4-10.9 24.8-26.1 29.8-43.3 4.9-17.3 3.3-35.7-2.3-52.5l-.4-1.2z" / > < / svg > < / a > < a href = https://twitter.com/linuxserverio target = _blank rel = noopener title = twitter.com class = md-social__link > < svg xmlns = http://www.w3.org/2000/svg viewbox = "0 0 448 512" > <!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc. --> < path d = "M400 32H48C21 . 5 32 0 53 . 5 0 80v352c0 26 . 5 21 . 5 48 48 48h352c26 . 5 0 48-21 . 5 48-48V80c0-26 . 5-21 . 5-48-48-48zm-48 . 9 158 . 8c . 2 2 . 8 . 2 5 . 7 . 2 8 . 5 0 86 . 7-66 186 . 6-186 . 6 186 . 6-37 . 2 0-71 . 7-10 . 8-100 . 7-29 . 4 5 . 3 . 6 10 . 4 . 8 15 . 8 . 8 30 . 7 0 58 . 9-10 . 4 81 . 4-28-28 . 8- . 6-53-19 . 5-61 . 3-45 . 5 10 . 1 1 . 5 19 . 2 1 . 5 29 . 6-1 . 2-30-6 . 1-52 . 5-32 . 5-52 . 5-64 . 4v- . 8c8 . 7 4 . 9 18 . 9 7 . 9 29 . 6 8 . 3a65 . 447 65 . 447 0 0 1-29 . 2-54 . 6c0-12 . 2 3 . 2-23 . 4 8 . 9-33 . 1 32 . 3 39 . 8 80 . 8 65 . 8 135 . 2 68 . 6-9 . 3-44 . 5 24-80 . 6 64-80 . 6 18 .
