Account Setup

Get your Architecto account configured and ready to start designing architectures.

Creating Your Account

Visit architecto.dev and choose your authentication method:

Email & Password

• Enter email address
• Create a strong password
• Verify email (check inbox for verification link)

OAuth (GitHub, Google, Microsoft)

• Click your provider button
• Authorize Architecto to access your profile
• Account created automatically

Magic Link

• Enter email address
• Click link sent to your inbox
• No password required

Passkey (Biometric)

• Recommended for enhanced security
• Works with Windows Hello, Face ID, Touch ID, or YubiKey
• One-click secure login

Setting Up Your Workspace

Profile Information

1. Click Account → Profile in navigation
2. Update:
   • Display Name — How your name appears in comments and sharing
   • Avatar — Your profile picture
   • Bio — Brief description (optional)

Preferences

1. Click Account → Preferences
2. Configure:
   • Theme — Light or Dark mode
   • Default Cloud Provider — AWS, GCP, or Azure (influences pattern suggestions)
   • Default Export Format — PNG, PPT, or PDF
   • Timezone — For quiz scheduling and deadline handling
   • Language — English or Deutsch (more coming)

Notification Settings

1. Click Account → Notifications
2. Choose:
   • Email Notifications — Architecture shares, comments, team invitations
   • Digest Frequency — Immediate, daily, or weekly summaries
   • Quiz Reminders — Daily quiz and flashcard reminders

Organizations & Teams

Creating an Organization

If you plan to work with a team:

1. Click Organizations → Create Organization
2. Enter:
   • Organization Name — Your company or project name
   • Slug — URL-friendly identifier
   • Description — Purpose and scope
   • Logo — (Optional) Brand identity
3. Click Create

Adding Team Members

1. Go to Organization Settings → Members
2. Click Invite Members
3. Enter email addresses (comma-separated for multiple)
4. Assign role:
   • Owner — Full access, can delete organization, manage billing
   • Admin — Create/edit architectures, manage members, view billing
   • Member — Create/edit their own architectures, view shared ones
   • Viewer — Read-only access to shared architectures

Managing Invitations

• Members receive email invitations
• Click link to accept and join organization
• Can adjust roles anytime from Members settings

Billing & Subscription

Plans

Architecto offers three tiers:

Upgrading Your Plan

1. Click Billing → Current Plan
2. Click Upgrade to Pro or Upgrade to Ultimate
3. Enter payment information (Stripe)
4. Plan upgrades immediately
5. Prorated charges if upgrading mid-cycle

Organizational Licensing

For teams, Architecto offers bulk licensing:

• Contact sales@architecto.dev for quote
• Licenses include all Pro features
• Centralized billing and seat management
• Dedicated support
• Custom feature development available

Security

Two-Factor Authentication (2FA)

1. Go to Account → Security
2. Click Enable 2FA
3. Choose method:
   • Authenticator App (Google Authenticator, Authy, Microsoft Authenticator)
   • SMS (text message verification)
4. Scan QR code or enter manual key
5. Enter verification code to confirm

Active Sessions

1. Go to Account → Security → Active Sessions
2. View all logged-in devices:
   • Browser — Chrome, Firefox, Safari
   • Device — Windows, Mac, iPhone
   • Location — Approximate location
   • Last Active — When last used
3. Click Sign Out to revoke any session

API Keys

For programmatic access to Architecto API:

1. Go to Developer → API Keys
2. Click Create New Key
3. Enter:
   • Name — Descriptive name (e.g., "CI/CD Pipeline")
   • Expires — Never, 30 days, 90 days, 1 year
   • Scopes — Select permissions (read, write, admin)
4. Copy key and store securely (you won't see it again)
5. Use in API requests: Authorization: Bearer YOUR_API_KEY

To revoke a key:

• Go to Developer → API Keys
• Click Revoke next to the key
• Revocation is immediate

Connecting External Services

GitHub Integration

1. Go to Integrations → GitHub
2. Click Connect GitHub
3. Authorize Architecto to access repositories
4. Choose:
   • All repositories — Or specific repositories
   • Permissions: Read-only (recommended)
5. Use GitHub repos when importing Terraform or creating CoDocs

Discord Integration

1. Go to Integrations → Discord
2. Click Add to Discord
3. Select your workspace and authorize
4. Configure notifications:
   • Shared architectures
   • Comments on diagrams
   • Team invitations
5. Set #channel for notifications

Jira Integration

1. Go to Integrations → Jira
2. Enter Jira Cloud ID (found in Jira settings)
3. Generate and paste API token
4. Link architectures to Jira issues (coming soon)

Storage & Data

Architecture Backups

• All architectures auto-saved to cloud
• Changes synced in real-time
• No manual backup required

Data Export

• Export all your architectures as JSON
• Download all comments and feedback
• Portable format for migration or archival

Data Deletion

• Individual architectures can be deleted anytime (permanent)
• Organization data retained for 30 days after deletion (for recovery)
• Full account deletion available in Account Settings

Next Steps

• Create First Architecture → First Architecture
• Explore Features → Features Guide
• Learn Analysis → Understanding Analysis

---

Need Help? Check FAQ or contact support@architecto.dev