File size: 1,870 Bytes
38ccfa4
7c1a9d1
 
 
 
38ccfa4
7c1a9d1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
38ccfa4
 
7c1a9d1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
---
title: OpenWebUI with Data Sync
emoji: πŸ”„
colorFrom: blue
colorTo: purple
sdk: docker
pinned: true
app_port: 8080
suggested_hardware: cpu-basic
suggested_storage: medium
short_description: OpenWebUI with automated GitHub data sync
tags:
  - openwebui
  - chat
  - llm
  - ai
  - docker
  - data-sync
  - backup
models:
  - openai-community/gpt2
datasets:
  - openwebui/openwebui
---

# OpenWebUI with Data Synchronization

A self-hosted OpenWebUI instance with automated data backup and synchronization to GitHub repositories.

## Features

- πŸ€– **OpenWebUI Interface**: Full-featured chat interface for AI models
- πŸ”„ **Automated Data Sync**: Automatic backup to GitHub repository every hour
- πŸ”’ **Private Storage**: Secure data storage in your private GitHub repo
- πŸ“Š **Persistent Data**: Never lose your conversations and settings
- 🐳 **Docker Ready**: Easy deployment on Hugging Face Spaces

## Environment Variables

Set these in your Space's Repository secrets:

### Required
- `G_NAME`: Your GitHub repository (e.g., `username/repo-name`)
- `G_TOKEN`: GitHub Personal Access Token with repo access

### Optional
- `WEBDAV_URL`: WebDAV server URL for additional backup
- `WEBDAV_USERNAME`: WebDAV username
- `WEBDAV_PASSWORD`: WebDAV password

## Setup Instructions

1. Create a private GitHub repository for data backup
2. Generate a GitHub Personal Access Token with repo permissions
3. Add the environment variables to your Space's Repository secrets
4. Deploy and enjoy persistent OpenWebUI!

## Data Synchronization

The system automatically:
- Syncs every hour (08:00-24:00 Beijing time)
- Backs up `webui.db` to your GitHub repository
- Creates versioned commits with timestamps
- Handles conflicts and retries on failures

Check out the [configuration reference](https://huggingface.co/docs/hub/spaces-config-reference) for more details.