Docker Survival Guide: Downgrading and Fixing Persistence

-


If you've been self-hosting for a while, you know the drill: you see an update, you click pull, and suddenly—everything breaks. Recently, a bug in the latest version of File Browser caused some headaches, requiring a strategic downgrade to a stable version. But there was a catch—my database wasn't persistent!

In this post, I’ll show you how to downgrade safely and, more importantly, how to rebase your directory so your settings never vanish again.

The Scenario: Buggy Updates

Sometimes, "latest" isn't "greatest." Due to recent compilation bugs in the current File Browser release, the community recommendation is to pin your version to v2.35.0. If you just change the tag and restart, you might realize your users and settings have disappeared. This happens because the database was living inside the container's temporary filesystem.

Step 1: The "Self-Contained" Directory Strategy

Instead of letting Docker decide where to put your data, we are rebasing everything into a single, portable folder: ~/filebrowser. This folder will hold your docker-compose.yml and your filebrowser.db.

# Create and enter your app directory mkdir -p ~/filebrowser cd ~/filebrowser

Create the persistent database file on the host
touch filebrowser.db chmod 664 filebrowser.db

Step 2: The Optimized Docker-Compose

By using relative paths (./), we tell Docker to look for the database in the same folder as the compose file. We also "lock" the image version to avoid future buggy updates.

version: '3' services: filebrowser: image: filebrowser/filebrowser:v2.35.0 container_name: filebrowser ports: - "8080:80" volumes: - /path/to/your/actual/files:/srv # The Magic Line: Mapping the DB to the host - ./filebrowser.db:/database/filebrowser.db restart: unless-stopped

Step 3: Deploy and Verify

Run the following to recreate the container with the stable version and persistent mapping:

docker compose up -d --force-recreate

Now, even if you delete the container or downgrade again, your filebrowser.db stays safe on your Debian host.

Bonus: The "Instant Backup" Command

Since everything is now in ~/filebrowser, you can backup your entire configuration (users, settings, and database) with one command:

tar -czvf ~/fb_backup_$(date +%F).tar.gz ~/filebrowser

Conclusion

Docker volumes can be tricky. By rebasing your apps into self-contained directories and using specific version tags instead of :latest, you gain full control over your home server. Happy (stable) hosting!


Support My Work

If this blog post helped you, please consider a small donation. Your support helps keep this content free and accessible for everyone. Thank you!

Donate with PayPal

The easiest way to support me is by buying me a coffee through PayPal. It's quick, secure, and uses a trusted platform.

Buy Me a Coffee! or a new Macbook!

Donate with Crypto

You can also support me with cryptocurrency. Just copy the address of your preferred coin below.

Bitcoin
31kpUFfNo8SSq5jidTY9Eihyb9qJS4FPP2
Ethereum
0x32fB1E082EB566bBbca3137a5a17a92db9C880F7
XRP
rsRy14FvipgqudiGmptJBhr1RtpsgfzKMM
XRP Tag
3802858062

Comments

Post a Comment

Popular posts from this blog

Self-Hosted Personal Cloud: From Old Laptop to Fully Private Cloud

-
Image
Assalamualaikum and greetings from Semenyih ! This is your complete A-to-Z guide for turning an old laptop and a WD My Cloud NAS into a secure, self-hosted cloud server — fully under your control and accessible from anywhere in the world. This journey combines the best of both worlds: the raw technical depth from my original build notes and a beginner-friendly, step-by-step flow. Whether you're here to learn the basics or to dive straight into Docker configs, you'll find what you need. Why I Built This Western Digital discontinued remote access support for older WD My Cloud devices, essentially turning them into local-only storage. Rather than letting mine gather dust, I built a replacement cloud service using Debian Linux, Docker, Nextcloud , and Nginx Proxy Manager — bringing back remote access and adding more privacy, flexibility, a...
Read more

How to Download AnyFlip Books as PDFs with Anyflip Downloader

-
Image
Have you ever needed an offline copy of a digital flipbook from AnyFlip for research, archiving, or easy reading on any device? While the platform is great for online viewing, saving content locally can be a challenge. Introducing anyflip-downloader , a powerful and efficient open-source command-line tool from developer Lofter1 , available on GitHub . It's designed to download any AnyFlip book and convert it into a single, high-quality PDF file. This guide will walk you through everything you need to know, from installation to advanced usage, to get the most out of this handy utility. Important Disclaimer This tool is provided for educational and personal use only. You should only use it to download books that you have the right to, or where the publisher officially allows PDF downloads. Please respect copyright laws and the terms of service of AnyFlip. Key Features Simple to Use: Works with a single command. ...
Read more

Mastering WordPress Multisite in cPanel: A Complete Guide

-
Image
Mastering WordPress Multisite in cPanel: A Complete Guide WordPress Multisite is a powerful feature that allows you to run a "network" of multiple websites from a single WordPress installation. For users managing their hosting through cPanel, this setup offers an efficient way to manage themes, plugins, and core updates for dozens or even hundreds of sites simultaneously. Whether you are building a university network, a franchise system, or a personal blog collection, understanding how this architecture works is the first step toward better web management. How Multisite Works Under the Hood Unlike a standard installation, a Multisite network shares its core PHP files and a single database. When you add a new site to the network, WordPress doesn't create a new folder on your server; instead, it creates unique tables within the existing database (e.g., wp_2_posts) and organizes media files into si...
Read more