Data Directory

RTILA X stores all its data in a single directory on your computer. Understanding the data directory structure helps you back up your data, troubleshoot issues, and manage disk space.

Location Per Platform

Platform	Data Directory
Windows	C:\Users\YourUsername\.rtila-x\
macOS	/Users/YourUsername/.rtila-x/
Linux	/home/YourUsername/.rtila-x/

The directory is hidden by default on macOS and Linux (starts with a dot). To view it:

• macOS: Press Cmd+Shift+G in Finder and type ~/.rtila-x
• Linux: Press Ctrl+H in the file manager to show hidden files
• Windows: The directory is visible by default

Directory Structure

~/.rtila-x/
├── database/
│   ├── data/
│   │   ├── backups/              ← Database backups
│   │   │   ├── backup_20250115_143000.zip
│   │   │   └── backup_20250116_143000.zip
│   │   └── data.db               ← PocketBase database file
│   ├── migrations/               ← Database schema migrations (temporary)
│   ├── hooks/                    ← Database hooks (JavaScript)
│   └── .db_key                   ← Superuser password (auto-generated)
├── profiles/
│   ├── default/                  ← Default browser profile
│   │   ├── cookies/              ← Browser cookies
│   │   ├── cache/                ← Browser cache
│   │   ├── extensions/           ← Injected browser extensions
│   │   └── config/               ← Profile configuration
│   ├── <profile-id-1>/           ← Custom browser profile 1
│   │   └── ...
│   ├── <profile-id-2>/           ← Custom browser profile 2
│   │   └── ...
│   └── proxy_ext_<hash>/         ← Auto-generated proxy auth extensions
│       └── ...
├── models/                       ← Downloaded AI models (GGUF files)
│   ├── Qwen2.5-7B-Instruct-Q4_K_M.gguf
│   └── Meta-Llama-3.1-8B-Instruct-Q4_K_M.gguf
├── logs/                         ← Application logs
│   └── execution_log.txt
├── output/                       ← Output files from automations
│   ├── downloads/                ← Downloaded files
│   └── ...
├── checkpoints/                  ← Checkpoint files (file mode)
│   └── project_name.json
├── .machine_id                   ← Unique machine identifier
└── rtila-extension/              ← Extracted browser extension
    └── ...

Directory Contents Explained

Directory/File	Description
database/data/data.db	The PocketBase database file. Contains all projects, sessions, logs, notifications, chats, messages, schedulers, queue records, users, licenses, browser profiles, global variables, bots, trigger chains, and audit logs.
database/data/backups/	Automatic and manual database backups.
database/.db_key	The auto-generated superuser password for the PocketBase database.
profiles/	Browser profile directories. Each profile has its own cookies, cache, and extensions.
models/	Downloaded AI model files (GGUF format).
logs/	Application execution logs.
output/	Output files generated by automations (exported data, downloaded files, screenshots).
checkpoints/	Checkpoint files for file-mode projects (not connected to the database).
.machine_id	A unique identifier for this machine, used for license activation.
rtila-extension/	The extracted CRXJS browser extension used by the Visual Builder.

Opening the Data Directory

Via Preferences

1. Go to Preferences → General → Administration → Open Administration Tools.
2. Go to the Advanced tab.
3. Click “Open Application Data Folder”.

Manually

Navigate to the data directory in your file manager:

• Windows: Open File Explorer and navigate to C:\Users\YourUsername\.rtila-x\
• macOS: Open Finder, press Cmd+Shift+G, type ~/.rtila-x
• Linux: Open the file manager, press Ctrl+H, navigate to ~/.rtila-x/

Backing Up Your Data

What to Back Up

Data	Location	Priority
Database	database/data/data.db	Critical — contains all projects, sessions, settings
Browser profiles	profiles/	High — contains login sessions, cookies
AI models	models/	Medium — can be re-downloaded
Output files	output/	Medium — can be re-generated
Machine ID	.machine_id	Low — regenerated if missing

Backup Methods

Method 1: Copy the entire directory

The simplest backup method is to copy the entire ~/.rtila-x/ directory:

# macOS/Linux
cp -r ~/.rtila-x/ ~/backups/rtila-backup-$(date +%Y%m%d)/

# Windows (PowerShell)
Copy-Item -Path "$env:USERPROFILE\.rtila-x" -Destination "$env:USERPROFILE\backups\rtila-backup" -Recurse

Method 2: Use the built-in backup feature

1. Go to Preferences → General → Administration → Open Administration Tools.
2. Go to the Backups tab.
3. Click “New Backup” to create a database backup.
4. Click “Open Folder” to access the backup files.

Method 3: Copy specific directories

If you only need to back up specific data:

# Back up only the database
cp ~/.rtila-x/database/data/data.db ~/backups/

# Back up browser profiles
cp -r ~/.rtila-x/profiles/ ~/backups/profiles/

# Back up AI models
cp -r ~/.rtila-x/models/ ~/backups/models/

Clearing Data

Clear Browser Profile Data

To clear a specific browser profile’s data:

1. Close RTILA X completely.
2. Navigate to ~/.rtila-x/profiles/<profile-id>/.
3. Delete the cookies/ directory to clear cookies.
4. Delete the cache/ directory to clear cache.
5. Restart RTILA X.

Clear All Data (Full Reset)

Warning: This deletes ALL data including projects, sessions, logs, and settings.

1. Close RTILA X completely.
2. Delete the entire ~/.rtila-x/ directory.
3. Restart RTILA X. It will re-initialize from scratch.

Clear AI Models Only

To free up disk space by removing AI models:

1. Close RTILA X completely.
2. Navigate to ~/.rtila-x/models/.
3. Delete the model files you want to remove.
4. Restart RTILA X. You’ll need to re-download the models to use them again.

Clear Output Files

To free up disk space by removing output files:

1. Close RTILA X completely.
2. Navigate to ~/.rtila-x/output/.
3. Delete the output files you want to remove.
4. Restart RTILA X.

Disk Space Management

Component	Typical Size	How to Reduce
Database	100-500 MB	Delete old sessions and logs
Browser profiles	100-500 MB per profile	Clear cache, delete unused profiles
AI models	4-10 GB per model	Delete unused models
Output files	Varies	Delete old output files
Backups	Varies	Reduce the number of backups kept
Checkpoints	Small	Automatically cleaned up

Disk Space Tips

Tip	Why It Matters
Delete unused AI models	Models are 4-10 GB each. Delete models you don’t use.
Clear browser cache regularly	Browser cache can grow to hundreds of MB.
Delete old output files	Output files accumulate over time.
Reduce backup retention	Reduce the number of automatic backups kept.
Delete old sessions	Old sessions and their data take up space.
Monitor disk space	Check disk space regularly to avoid running out.