First Steps

Now that TruSpace is running, let's walk through the essential first steps.

Create Your Account

1. Open TruSpace at http://localhost:3000 (or your configured domain)
2. Click "Register"
3. Fill in your details:
4. Username: Your unique identifier
5. Email: For notifications (stored locally)
6. Password: Minimum 8 characters

Local Storage

Your credentials are stored securely in the local SQLite database. Nothing is sent to external servers.

Login

After registration:

1. Enter your username/email
2. Enter your password
3. Click "Login"

You'll be taken to the Dashboard.

Create Your First Workspace

Workspaces organize your documents and collaborators.

1. Click "Create Workspace" on the dashboard
2. Enter a name for your workspace
3. Choose visibility:
4. Private: Only you and invited members
5. Public: Visible to all users on this node

flowchart LR
    A[Dashboard] --> B[Create Workspace]
    B --> C{Visibility}
    C -->|Private| D[Invite Members]
    C -->|Public| E[Anyone Can View]
    D --> F[Upload Documents]
    E --> F

Upload a Document

1. Open your workspace
2. Click "Upload" or drag & drop files
3. Supported formats:
4. PDF, Word, Excel, PowerPoint
5. Images (PNG, JPG, GIF)
6. Text files, Markdown
7. And more...

AI Analysis

If AI is enabled, documents are automatically analyzed after upload. This may take a few moments.

Explore AI Features

With AI enabled, you can:

Ask Questions About Documents

1. Open a document
2. Use the chat interface to ask questions
3. AI will respond based on document content

View AI Perspectives

1. Click "AI Perspectives" on a document
2. See pre-generated summaries and insights
3. Customize prompts in settings

Invite Collaborators

For private workspaces:

1. Open workspace settings
2. Click "Invite Member"
3. Enter their username or email
4. Set their permission level:
5. Viewer: Read-only access
6. Editor: Can upload and edit
7. Admin: Full control

Same Node Requirement

Collaborators must have an account on the same TruSpace node, or you need to connect nodes (see next section).

Connect to Other Nodes

To sync with other TruSpace installations:

Quick Connection

# On target node: Generate connection details
./scripts/fetch-connection.sh -e

# On your node: Use the connection file
./scripts/connectPeer-automatic.sh .connection .connection.password

Once connected:

• Workspaces are synced automatically
• Documents replicate across nodes
• AI perspectives are shared

Full Connection Guide

Explore Settings

User Settings

• Profile information
• Password change
• Notification preferences

System Status

Check the health of your TruSpace installation:

1. Go to Settings > System Status
2. View:
3. IPFS node status
4. Connected peers
5. Storage usage
6. AI model status

Common First-Time Actions

Action	How
Change password	Settings > Profile > Change Password
Dark mode	Toggle in header
View storage	Settings > System Status
Check connected peers	Settings > IPFS Status

What's Next?

• Organize Documents

  Learn advanced document management.

  Documents Guide

• Master AI Features

  Get the most from AI analysis.

  AI Features

• Understand Security

  Learn how your data is protected.

  Security

• Configure TruSpace

  Customize your installation.

  Configuration