Settings & Configuration

Comprehensive guide to configuring your Parslinks organization, projects, and account settings.

Organization Settings

Access organization settings: Settings → Organization

General Settings

Organization Information

Organization Name: Acme Corporation
Organization Slug: acme
Description: Our deployment platform
Website: https://acme.com
Logo: [Upload]

Organization Slug:

Used in URLs: acme.parslinks.app
Cannot be changed after creation
Must be unique across Parslinks

Organization Branding

Customize your organization's appearance:

Logo: Upload (recommended 512x512px)
Favicon: Upload (recommended 32x32px)
Brand Color: #FF6B00
Dark Mode Logo: Upload (optional)

Applied to:

Dashboard header
Email notifications
Deployment pages
Shared previews

Security Settings

Two-Factor Authentication

Require 2FA for all members:

☑ Require 2FA for all members
Grace Period: 7 days
Enforcement: Strict

Members without 2FA lose access after grace period.

IP Allowlist

Restrict access by IP address:

Allowed IP Addresses:
  203.0.113.0/24     Office Network
  198.51.100.50      VPN Gateway
  192.0.2.100        Home Office

Configuration:

Enable IP Allowlist
Add allowed IPs/ranges
Set emergency override (optional)
Save settings

Session Management

Configure session behavior:

Session Timeout: 30 days
Idle Timeout: 2 hours
Concurrent Sessions: 5 per user
Require Re-auth for: Sensitive actions

Single Sign-On (SSO)

Enable SSO for team login (Team plan+):

Supported Providers:

Google Workspace
Microsoft Azure AD
Okta
Auth0
OneLogin
Custom SAML 2.0

Setup:

Go to Security → SSO
Choose provider

Enter configuration:

SSO URL: https://sso.provider.com
Entity ID: parslinks-acme
Certificate: [Upload]

Test connection
Enable SSO

Options:

☐ Allow password login (alongside SSO)
☑ Auto-provision users
☑ Sync user attributes
☑ Enforce SSO (disable password login)

Integrations

Git Providers

Connect Git repositories:

GitHub

Status: Connected
Account: acme-org
Repositories: 45 available
Permissions: Read & Write

GitLab

Status: Not Connected
[Connect GitLab]

Bitbucket

Status: Not Connected
[Connect Bitbucket]

Configuration:

Click Connect for provider
Authorize Parslinks
Grant repository access
Select default repositories

Slack Integration

Get notifications in Slack:

Click Add to Slack
Choose workspace
Select channel

Configure notifications:

☑ Deployment started
☑ Deployment succeeded
☑ Deployment failed
☐ Comment added
☑ Domain verified

Discord Integration

Similar to Slack, for Discord:

Click Add to Discord
Select server and channel
Configure notification types

Webhook Integration

Send events to custom endpoints:

Webhook URL: https://api.example.com/webhook
Secret: [Generate]
Events:
  ☑ deployment.created
  ☑ deployment.ready
  ☑ deployment.failed
  ☑ domain.verified
  ☐ member.added

Payload Example:

{
  "event": "deployment.ready",
  "timestamp": "2024-01-15T10:30:00Z",
  "organization": "acme",
  "project": "my-app",
  "deployment": {
    "id": "dep_123",
    "url": "https://my-app.acme.parslinks.app",
    "status": "ready"
  }
}

Notification Settings

Configure email notifications:

Deployment Notifications:
  ☑ Deployment succeeded
  ☑ Deployment failed
  ☐ Deployment started
  ☑ Build taking longer than usual

Domain Notifications:
  ☑ Domain verified
  ☑ SSL certificate issued
  ☐ SSL certificate expiring soon

Team Notifications:
  ☑ New team member added
  ☐ Team member removed
  ☐ Role changed

Billing Notifications:
  ☑ Payment successful
  ☑ Payment failed
  ☑ Usage limit reached
  ☑ Invoice available

Audit Logs

View all organization activity (Team plan+):

[2024-01-15 14:30] [email protected] deployed my-app
[2024-01-15 14:25] [email protected] updated env variables
[2024-01-15 14:20] [email protected] added domain example.com
[2024-01-15 14:15] [email protected] invited new member

Filter by:

User
Action type
Date range
Project
Resource type

Export:

CSV format
JSON format
Date range selection

Project Settings

Access project settings: Select project → Settings

General

Project Information

Project Name: My Awesome App
Project Slug: my-app
Framework: Next.js
Description: Customer-facing web application

Project Status

Status: Active
☐ Pause Project (stop new deployments)
☐ Archive Project (hide from list)

Root Directory

For monorepos:

Root Directory: apps/web
Build Context: apps/web

Build & Development

Build Settings

Build Command: npm run build
Output Directory: .next
Install Command: npm install
Development Command: npm run dev

Framework Preset

Framework: Next.js
Auto-detected: Yes
Version: 14.x

Override Detection: No
Custom Configuration: [Edit]

Node.js Settings

Node Version: 18.x
Package Manager: npm
  Options:
  ○ npm
  ○ yarn
  ○ pnpm
  ○ bun

Build Environment

Build Environment Variables: Production
Include Development Variables: No

Build Cache: Enabled
Cache Dependencies: Yes
Cache Build Output: Yes

Build Resources

Build Timeout: 30 minutes
Build Memory: 8 GB (Team plan)
Build CPU: 4 cores

Git Integration

Repository

Repository: github.com/acme/my-app
Connected: Yes
Access: Read & Write

Production Branch

Production Branch: main
Auto Deploy: Enabled
Deploy Trigger: Push
Ignored Paths:
  - docs/**
  - **.md
  - LICENSE

Preview Deployments

Enable Preview Deployments: Yes
Preview Branch Pattern: *
Pull Request Previews: Enabled
Deploy on Comment: Yes

Deployment Protection

☑ Require status checks before deployment
☑ Require approval for production
Approvers:
  - [email protected]
  - [email protected]

Domains

Manage project domains:

Production Domain: my-app.acme.parslinks.app
Custom Domains:
  myapp.com (Active, SSL Valid)
  www.myapp.com → myapp.com (Redirect)

Domain Settings:

☑ Force HTTPS
☑ Auto-renew SSL
☐ HSTS Enabled
☐ WWW Redirect

Environment Variables

Manage per-environment:

Production (12 variables)
Preview (8 variables)
Development (10 variables)

[Add Variable] [Import] [Export]

Variable Visibility:

☐ Show sensitive values
☑ Mask secrets in logs
☑ Encrypt at rest

Functions

Configure serverless functions (if applicable):

Functions Directory: api/
Function Region: us-east-1
Function Memory: 1024 MB
Function Timeout: 10 seconds

Headers & Redirects

Custom Headers

Path: /*
Headers:
  X-Frame-Options: DENY
  X-Content-Type-Options: nosniff
  Strict-Transport-Security: max-age=31536000
  Permissions-Policy: geolocation=()

Redirects

Source: /old-page
Destination: /new-page
Type: 301 Permanent

Source: /docs/*
Destination: https://docs.example.com/:splat
Type: 301 Permanent

Rewrites

Source: /api/:path*
Destination: https://api.example.com/:path*

Performance

Caching

Build Cache: Enabled
Edge Cache: Enabled
Cache-Control Headers: Auto

Custom Cache Rules:
  /_next/static/* - Cache for 1 year
  /api/* - No cache

Image Optimization

Enable Image Optimization: Yes
Supported Formats: WebP, AVIF
Max Image Size: 10 MB
Cache Duration: 30 days

Compression

☑ Enable Gzip
☑ Enable Brotli
Compression Level: Medium

Advanced

Custom Build Image

Use Custom Docker Image: No
Image: node:18-alpine

Build Hooks

Before Build: npm run prebuild
After Build: npm run postbuild
Before Deploy: npm run predeploy
After Deploy: npm run postdeploy

Feature Flags

☑ Enable Edge Runtime
☑ Enable Incremental Static Regeneration
☐ Enable Middleware
☑ Enable Image Optimization

Deployment Regions

Primary Region: us-east-1
Additional Regions:
  ☑ eu-west-1 (Europe)
  ☑ ap-southeast-1 (Asia)
  ☐ sa-east-1 (South America)

Danger Zone

⚠️ Destructive Actions

Transfer Project
Transfer to another organization

Delete Project
Permanently delete this project

[Transfer] [Delete]

Account Settings

Personal account settings: User Menu → Settings

Profile

Name: John Doe
Email: [email protected]
Avatar: [Upload]
Bio: Full-stack developer
Location: San Francisco, CA
Website: https://johndoe.com

Authentication

Password

Current Password: ••••••••
New Password: ••••••••
Confirm Password: ••••••••

[Change Password]

Two-Factor Authentication

Status: Enabled
Method: Authenticator App
Backup Codes: 8 remaining

[View Backup Codes] [Disable 2FA]

Setup 2FA:

Click Enable 2FA
Scan QR code with authenticator app
Enter verification code
Save backup codes
2FA enabled

Connected Accounts

GitHub: Connected as johndoe
Google: Not Connected
GitLab: Not Connected

[Manage Connections]

Sessions

Active Sessions:
  🖥️ Chrome on Windows - San Francisco, CA (Current)
  📱 Safari on iPhone - San Francisco, CA (2h ago)
  🖥️ Firefox on macOS - New York, NY (1d ago)

[Revoke All Other Sessions]

Preferences

Appearance

Theme:
  ○ Light
  ○ Dark
  ● Auto (system preference)

Density:
  ● Comfortable
  ○ Compact

Sidebar:
  ● Expanded by default
  ○ Collapsed by default

Language & Region

Language: English (US)
Timezone: America/Los_Angeles (PST)
Date Format: MM/DD/YYYY
Time Format: 12-hour

Notifications

Email Notifications:
  ☑ Product updates
  ☑ Security alerts
  ☐ Marketing emails
  ☑ Weekly summary

Desktop Notifications:
  ☑ Deployment completed
  ☑ Build failed
  ☐ Comment mentions

Keyboard Shortcuts

☑ Enable keyboard shortcuts
☑ Show shortcut hints

Customize Shortcuts:
  Quick search: Cmd+K
  New project: N → P
  New deployment: N → D

API Tokens

Manage personal access tokens:

Personal Access Tokens:
  prod-deploy-token (Last used 2h ago)
  ci-cd-token (Last used 1d ago)

[Create Token]

Create Token:

Click Create Token

Enter details:

Name: prod-deploy-token
Scope: Read & Write
Expiration: 90 days

Copy token (shown once!)
Store securely

Privacy & Data

Data Export

Export all your data:

Export Format:
  ○ JSON
  ● ZIP (includes files)

Includes:
  ☑ Projects
  ☑ Deployments
  ☑ Settings
  ☑ Logs

[Request Export]

Account Deletion

Delete your account:

⚠️ Warning: This will:

Delete all personal projects
Remove you from organizations
Delete all data (irreversible)

Type "DELETE" to confirm: [___]
[Delete Account]

Default Settings

Set organization-wide defaults:

Default Build Settings

Default Node Version: 18.x
Default Package Manager: npm
Default Build Timeout: 30 minutes
Default Build Cache: Enabled

Default Deployment Settings

Auto Deploy: Enabled
Preview Deployments: Enabled
Require Approval: Disabled
Auto-merge Previews: Disabled

Default Security Settings

Force HTTPS: Enabled
Auto-renew SSL: Enabled
Password Protection: Disabled
IP Allowlist: Disabled

Import/Export Settings

Export Configuration

Export project configuration:

# Via Dashboard
Settings → Export Configuration

# Via CLI
parslinks config export --project my-app

# Output: parslinks.json
{
  "framework": "nextjs",
  "buildCommand": "npm run build",
  "outputDirectory": ".next",
  "environmentVariables": {...}
}

Import Configuration

Import to another project:

# Via Dashboard
Settings → Import Configuration → Upload File

# Via CLI
parslinks config import --file parslinks.json

Configuration as Code

Define settings in repository:

parslinks.json:

{
  "version": 2,
  "framework": "nextjs",
  "buildSettings": {
    "buildCommand": "npm run build",
    "outputDirectory": ".next",
    "installCommand": "npm install"
  },
  "deploySettings": {
    "productionBranch": "main",
    "autoPreview": true
  },
  "headers": [
    {
      "source": "/(.*)",
      "headers": [
        {
          "key": "X-Frame-Options",
          "value": "DENY"
        }
      ]
    }
  ],
  "redirects": [
    {
      "source": "/old-page",
      "destination": "/new-page",
      "permanent": true
    }
  ]
}

Best Practices

1. Security First

✅ Enable 2FA for all users
✅ Use SSO when available
✅ Regular access reviews
✅ Monitor audit logs
✅ Rotate API tokens

2. Optimize Builds

✅ Enable build cache
✅ Use appropriate Node version
✅ Optimize dependencies
✅ Set reasonable timeouts

3. Configure Notifications

✅ Enable deployment notifications
✅ Set up Slack/Discord
✅ Configure usage alerts
✅ Review weekly summaries

4. Document Settings

✅ Export configurations
✅ Version control parslinks.json
✅ Document custom settings
✅ Share with team

5. Regular Reviews

✅ Review settings quarterly
✅ Update integrations
✅ Clean up old tokens
✅ Optimize performance settings

Troubleshooting

Settings Not Saving

Check:

Permissions (are you owner/admin?)
Network connection
Browser console for errors
Try different browser

Build Configuration Not Applied

Solutions:

Redeploy after changing settings
Clear build cache
Verify settings in dashboard
Check parslinks.json syntax

Integration Not Working

Verify:

Integration is connected
Correct permissions granted
Webhook URLs are accessible
API tokens are valid

Frequently Asked Questions

Can I configure settings via API?

Yes! Most settings can be managed via API. See API documentation.

Do settings apply to existing deployments?

No. Settings apply to new deployments. Redeploy to apply changes.

Can I copy settings between projects?

Yes! Export from one project and import to another.

Are settings backed up?

Yes! All settings are automatically backed up and versioned.

Can I revert to previous settings?

Yes! Contact support to restore previous configuration.

Next Steps

Deployments

Deploy with your configuration

Team Management

Configure team settings

Security

Advanced security settings

API Reference

Manage settings via API

Settings & Configuration

Deployments

Team Management

Security

API Reference

On this page