Skip to main content

Projects & Workspaces

Organize your resources, manage team access, and streamline billing with Lineserve's project and workspace management system.

Overview​

Projects​

Projects are containers for organizing related resources:

  • Resource Grouping: Group VPS, databases, storage by project
  • Team Collaboration: Share projects with team members
  • Billing Separation: Separate billing for different projects
  • Access Control: Fine-grained permissions per project

Workspaces​

Workspaces are higher-level containers for multiple projects:

  • Organization Level: Manage multiple projects under one workspace
  • Team Management: Centralized user and permission management
  • Billing Consolidation: Unified billing across all projects
  • Resource Quotas: Set limits across workspace projects

Project Management​

Creating Projects​

Create projects to organize your resources:

  1. Navigate to Projects: Go to Account > Projects
  2. Create New Project: Click "Create Project"
  3. Project Details:
    • Name: Descriptive project name
    • Description: Optional project description
    • Region: Default region for resources
    • Budget: Optional spending limits

Project Structure​

Workspace: "Acme Corp"
├── Project: "Production"
│   ├── VPS: web-server-prod
│   ├── Database: app-db-prod
│   └── Storage: backup-storage
├── Project: "Staging"
│   ├── VPS: web-server-staging
│   └── Database: app-db-staging
└── Project: "Development"
    ├── VPS: dev-server
    └── Database: dev-db

Project Settings​

Configure project-specific settings:

  • Default Region: Primary region for new resources
  • Resource Limits: Maximum resources per project
  • Billing Alerts: Spending notifications
  • Auto-shutdown: Automatic resource cleanup

Workspace Management​

Creating Workspaces​

Workspaces help organize multiple projects:

  1. Workspace Creation: Available for team accounts
  2. Workspace Settings:
    • Name: Organization or team name
    • Description: Workspace purpose
    • Billing Account: Primary billing account
    • Default Quotas: Resource limits for projects

Workspace Features​

  • Centralized Billing: Single invoice for all projects
  • User Management: Add/remove team members
  • Permission Templates: Predefined role templates
  • Resource Quotas: Workspace-wide resource limits
  • Audit Logging: Track all workspace activities

Team Collaboration​

User Roles​

Different roles provide different levels of access:

Owner​

  • Full Access: Complete control over workspace/project
  • Billing Management: Manage payment methods and billing
  • User Management: Add/remove users and assign roles
  • Resource Management: Create, modify, delete all resources

Admin​

  • Resource Management: Full resource control
  • User Management: Manage team members (except owners)
  • Project Settings: Configure project settings
  • Billing View: View billing information (no changes)

Developer​

  • Resource Access: Create and manage assigned resources
  • Project View: View project information and metrics
  • Limited Billing: View usage and costs
  • API Access: Full API access for assigned resources

Viewer​

  • Read-only Access: View resources and configurations
  • Monitoring: Access to metrics and logs
  • No Modifications: Cannot create or modify resources
  • Limited API: Read-only API access

Inviting Team Members​

Add team members to your workspace or project:

  1. Navigate to Team: Go to Project/Workspace > Team
  2. Send Invitation: Enter email address and select role
  3. Set Permissions: Configure specific permissions
  4. Invitation Email: Team member receives invitation link

Permission Management​

Fine-tune access control:

  • Resource-level Permissions: Control access to specific resources
  • Service Permissions: Limit access to specific services
  • Regional Restrictions: Restrict access to certain regions
  • Time-based Access: Temporary access permissions

Resource Organization​

Tagging System​

Use tags to organize and track resources:

  • Environment Tags: production, staging, development
  • Team Tags: frontend, backend, devops
  • Cost Center Tags: marketing, engineering, sales
  • Custom Tags: Any key-value pairs

Resource Naming​

Establish naming conventions:

Format: {project}-{service}-{environment}-{instance}
Examples:
- ecommerce-web-prod-01
- blog-db-staging-mysql
- api-cache-dev-redis

Resource Groups​

Group related resources:

  • Application Stack: Web server + database + cache
  • Environment Group: All staging resources
  • Service Group: All databases across projects
  • Regional Group: Resources in specific region

Billing & Cost Management​

Project-level Billing​

Each project has separate billing:

  • Individual Invoices: Separate invoice per project
  • Cost Allocation: Track costs by project
  • Budget Alerts: Spending notifications per project
  • Usage Reports: Detailed usage breakdown

Workspace Billing​

Consolidated billing for all projects:

  • Unified Invoice: Single invoice for entire workspace
  • Cost Centers: Allocate costs to different departments
  • Chargeback Reports: Internal cost allocation
  • Budget Management: Workspace-wide budget controls

Cost Optimization​

Tools to optimize spending:

  • Resource Recommendations: Suggestions for cost savings
  • Unused Resources: Identify idle or unused resources
  • Right-sizing: Optimize resource configurations
  • Reserved Instances: Long-term commitments for discounts

API Integration​

Project API​

Manage projects programmatically:

# List projects
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lineserve.com/v1/projects

# Create project
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New Project",
    "description": "Project for new application",
    "region": "nairobi",
    "budget_limit": 1000
  }' \
  https://api.lineserve.com/v1/projects

# Get project details
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lineserve.com/v1/projects/{project_id}

Resource Management​

Deploy resources within projects:

# Create VPS in specific project
curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-server",
    "project_id": "proj_123",
    "region": "nairobi",
    "image": "ubuntu-22.04",
    "size": "starter"
  }' \
  https://api.lineserve.com/v1/vps

# List project resources
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.lineserve.com/v1/projects/{project_id}/resources

CLI Commands​

Project Management​

# List projects
lineserve projects list

# Create project
lineserve projects create \
  --name "My Project" \
  --description "New application project" \
  --region nairobi

# Switch to project
lineserve projects use my-project

# Show current project
lineserve projects current

Resource Deployment​

# Deploy VPS in current project
lineserve vps create \
  --name web-server \
  --image ubuntu-22.04 \
  --size starter

# Deploy in specific project
lineserve vps create \
  --name web-server \
  --project my-project \
  --image ubuntu-22.04 \
  --size starter

Best Practices​

Project Organization​

  • Environment Separation: Separate projects for prod/staging/dev
  • Service Isolation: Separate projects for different applications
  • Team Alignment: Align projects with team structure
  • Clear Naming: Use descriptive project names

Access Control​

  • Principle of Least Privilege: Grant minimum required access
  • Regular Reviews: Periodically review team access
  • Role-based Access: Use predefined roles when possible
  • Temporary Access: Use time-limited permissions for contractors

Cost Management​

  • Budget Alerts: Set up spending notifications
  • Regular Reviews: Monthly cost reviews per project
  • Resource Tagging: Consistent tagging for cost tracking
  • Cleanup Policies: Regular cleanup of unused resources

Migration & Import​

Existing Resources​

Move existing resources to projects:

  1. Resource Assessment: Identify resources to organize
  2. Project Creation: Create appropriate projects
  3. Resource Migration: Move resources to projects
  4. Team Assignment: Assign team members to projects

Bulk Operations​

Manage multiple resources efficiently:

  • Bulk Tagging: Apply tags to multiple resources
  • Batch Operations: Perform actions on resource groups
  • Import/Export: Import configurations from other platforms
  • Template Deployment: Deploy standardized configurations

Monitoring & Reporting​

Project Dashboards​

Monitor project health and usage:

  • Resource Overview: All project resources at a glance
  • Performance Metrics: CPU, memory, storage usage
  • Cost Tracking: Real-time spending information
  • Alert Status: Current alerts and notifications

Reporting​

Generate reports for projects and workspaces:

  • Usage Reports: Resource utilization over time
  • Cost Reports: Detailed spending breakdown
  • Performance Reports: Application performance metrics
  • Compliance Reports: Security and compliance status

Troubleshooting​

Common Issues​

Access Problems​

  • Permission Denied: Check user role and permissions
  • Resource Not Found: Verify project access
  • API Errors: Ensure correct project context
  • Team Invitations: Check email and spam folders

Billing Issues​

  • Cost Allocation: Verify project billing settings
  • Budget Alerts: Check alert configuration
  • Invoice Questions: Review project-specific charges
  • Payment Failures: Verify payment method for workspace

Getting Help​

  • Project Support: projects@lineserve.com
  • Documentation: Comprehensive project guides
  • Live Chat: Available in web console
  • Phone Support: +254 700 123 456

Next Steps​