[GH-ISSUE #1364] FR: First-class data backups #873

Closed
opened 2026-03-02 11:53:24 +03:00 by kerem · 4 comments
Owner

Originally created by @asg0451 on GitHub (May 6, 2025).
Original GitHub issue: https://github.com/karakeep-app/karakeep/issues/1364

Describe the feature you'd like

I just lost my karakeep collection in a drive failure. It was running on a random drive instead of my nas since sqlite doesnt like running over smb. So, setting it back up again, what's the recommended way to do backups?

I've used litestream before with success but i'm not sure if /data/{db.db,queue.db} will always be the databases and I don't want to have to reevaluate my backup strategy every new version release. i also dont believe it's safe to just rsync a running sqlite db (am i wrong?).

So, what's the recommended way to back up karakeep databases?

Describe the benefits this would bring to existing Karakeep users

not losing data

Can the goal of this request already be achieved via other means?

yes but i'd like to have official guidance

Have you searched for an existing open/closed issue?

  • I have searched for existing issues and none cover my fundamental request

Additional context

No response

Originally created by @asg0451 on GitHub (May 6, 2025). Original GitHub issue: https://github.com/karakeep-app/karakeep/issues/1364 ### Describe the feature you'd like I just lost my karakeep collection in a drive failure. It was running on a random drive instead of my nas since sqlite doesnt like running over smb. So, setting it back up again, what's the recommended way to do backups? I've used litestream before with success but i'm not sure if `/data/{db.db,queue.db}` will always be the databases and I don't want to have to reevaluate my backup strategy every new version release. i also dont believe it's safe to just rsync a running sqlite db (am i wrong?). So, what's the recommended way to back up karakeep databases? ### Describe the benefits this would bring to existing Karakeep users not losing data ### Can the goal of this request already be achieved via other means? yes but i'd like to have official guidance ### Have you searched for an existing open/closed issue? - [x] I have searched for existing issues and none cover my fundamental request ### Additional context _No response_
kerem closed this issue 2026-03-02 11:53:24 +03:00
Author
Owner

@kriskras69 commented on GitHub (May 7, 2025):

I sync the Karakeep folder to the cloud and to another external drive but first
i do sign out and stop the containers.
I make a local copy every now and then just to be on the safe side.
Loosing my karakeep would be very bad.

<!-- gh-comment-id:2857935310 --> @kriskras69 commented on GitHub (May 7, 2025): I sync the Karakeep folder to the cloud and to another external drive but first i do sign out and stop the containers. I make a local copy every now and then just to be on the safe side. Loosing my karakeep would be very bad.
Author
Owner

@wheeljack73 commented on GitHub (May 7, 2025):

The only thing keeping me from using Karakeep over Linkwarden is the lack of a full export option. I found Karakeep recently imported everything from Linkwarden and started having a reorganise. I hadn’t checked on the export situation beforehand and assumed the normal export would be fine. Exported, wiped my docker stack and set it up elsewhere. Upon reimport found it just imported them all as one big list…so all the work I’d done had been lost.

Admittedly I should have checked first, so not laying any blame other than on myself. I’m currently building my own stack and seeing how things work and would have appreciated a full export/import that retains all the lists etc. Also appreciate the decent android app so may move anyway and figure out what to do for backup but a full export facility would be useful…I’m sure others would agree.

Great app though, one to keep an eye on :)

<!-- gh-comment-id:2858803860 --> @wheeljack73 commented on GitHub (May 7, 2025): The only thing keeping me from using Karakeep over Linkwarden is the lack of a full export option. I found Karakeep recently imported everything from Linkwarden and started having a reorganise. I hadn’t checked on the export situation beforehand and assumed the normal export would be fine. Exported, wiped my docker stack and set it up elsewhere. Upon reimport found it just imported them all as one big list…so all the work I’d done had been lost. Admittedly I should have checked first, so not laying any blame other than on myself. I’m currently building my own stack and seeing how things work and would have appreciated a full export/import that retains all the lists etc. Also appreciate the decent android app so may move anyway and figure out what to do for backup but a full export facility would be useful…I’m sure others would agree. Great app though, one to keep an eye on :)
Author
Owner

@MohamedBassem commented on GitHub (May 10, 2025):

@asg0451 I'm really sorry to hear you lost your collection. The advice that I have been giving to people is to backup the entire data dir (stop karakeep, zip the data dir, and restart it again). Using litestream would only backup the database but not the assets (all thumbnails, archives, etc). Personally, I have two layers. One that rsyncs the files themseleves (and I take the risk of resync-ing myself), and the other one that takes ZFS snapshots for the entire machine.

I think this topic comes up frequently, and this issue convinced me that I probably add first class support for this in Karakeep. So I'll mark this as approved and label it as high-pri. Again, very sorry to hear you lost your collection.

<!-- gh-comment-id:2868943608 --> @MohamedBassem commented on GitHub (May 10, 2025): @asg0451 I'm really sorry to hear you lost your collection. The advice that I have been giving to people is to backup the entire data dir (stop karakeep, zip the data dir, and restart it again). Using litestream would only backup the database but not the assets (all thumbnails, archives, etc). Personally, I have two layers. One that rsyncs the files themseleves (and I take the risk of resync-ing myself), and the other one that takes ZFS snapshots for the entire machine. I think this topic comes up frequently, and this issue convinced me that I probably add first class support for this in Karakeep. So I'll mark this as approved and label it as high-pri. Again, very sorry to hear you lost your collection.
Author
Owner

@MohamedBassem commented on GitHub (May 10, 2025):

Actually, let's track this in the original issue #75

<!-- gh-comment-id:2868950709 --> @MohamedBassem commented on GitHub (May 10, 2025): Actually, let's track this in the original issue #75
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/karakeep#873
No description provided.