Documentation

Getting Started

Welcome to NotionSafe! This guide will help you set up your first automatic Notion backup in less than 5 minutes.

Prerequisites

Before you begin, make sure you have:

  • A Notion account with at least one workspace.
  • A Notion API Token (Internal Integration Token).

How to get a Notion API Token?

1. Go to Notion Integrations.
2. Click + New integration.
3. Give it a name (e.g., "NotionSafe Backup") and select the workspace.
4. Submit and copy the Internal Integration Token.

Step 1: Install NotionSafe

Download the latest version of NotionSafe for your operating system from the GitHub Releases page.

  • Windows: Download notionsafe.exe and run it.
  • Linux: Download the .tar.gz or use the COPR/AUR package (see Installation).

Step 2: Run the Configuration Wizard

When you first launch the app, the Configuration Wizard will guide you through the setup.

  1. Notion Token: Paste your API token. NotionSafe will verify it and store it securely in your system's keyring.
  2. Storage: Choose where you want to store your backups (local folder or an external drive).
  3. Schedule: Decide how often you want NotionSafe to run (e.g., every 6 hours, daily, etc.).

Step 3: Your First Backup

Once configured, you can click "Start Backup" from the main dashboard to run your first manual backup. NotionSafe will create a timestamped folder containing your entire Notion workspace in Markdown and CSV formats.

Pro Tip: Git Integration

Enable Git integration in the settings to track changes over time. NotionSafe will automatically commit and push your backups to a private Git repository of your choice.