Troubleshooting & Help ‐ Common procedures ‐ Docker cleanup

🧭 You are here : Wiki home / Troubleshooting & Help / Common procedures / Docker cleanup

---

CRCON uses Docker to bring you a complete working environment, so you don't have to worry about installing or maintaining anything it needs (Python, PostgreSQL, Redis, Django, Nginx, etc) to run it on your machine.

Distributing an application using Docker relies on "images" and "containers" files downloads.
For each new release of CRCON, we ask you to "pull" new versions of these on your machine.

You may also have built some local Docker containers and images if you're using custom scripts or code in CRCON.

As time passes, Docker's data folder can get quite large, mostly being filled with replaced containers, images or build cache you'll never use again.

Here's a procedure you can use to clean Docker's data folders.

Warning

This maintenance procedure will DELETE unused and unlinked Docker datafiles.
You can't really loose anything important, as this won't affect your CRCON database or config files.
Still, you'll be advised to always have a fresh backup of a known-to-be-working CRCON install.

1. Make sure CRCON is up and running

This isn't mandatory, but will prevent the deletion of any container, image, volume or network CRCON is actually using.
If CRCON isn't up at the moment you're asking Docker to clean itself, you may loose files that will be recreated on the next CRCON start.

Check if CRCON Docker containers are up and running :

cd /root/hll_rcon_tool
docker compose ps

You should get something like this :

If CRCON or one of its containers isn't up, try to restart :

docker compose up -d --remove-orphans

If CRCON or one of its containers still isn't up, look for help in Common issues and their solutions.

2. Ask Docker to clean its data folders

Reference : https://docs.docker.com/reference/cli/docker/system/prune/

docker system prune -a -f --volumes

It will display volumes, images, build cache, etc names as they're deleted.

At the end, you'll get a report telling you how many storage space has been freed.
If you're using CRCON since a long time, this can be counted in GBs !

Note

If you're building your own CRCON images, the next building process will take some time, as all the cached building data has been deleted.