Skip to main content

Quick Setup Guide

Get MedFeed up and running in your environment quickly with this streamlined setup process.

Prerequisites Checklist​

Before starting, ensure you have:

  • Ubuntu 20.04+ or CentOS 8+ server
  • Node.js v22.14.0 installed
  • MongoDB 6.0+ running
  • Redis 7.0+ running
  • Domain name with SSL certificate
  • AWS S3 bucket configured
  • SMTP server credentials

[Screenshot placeholder: Prerequisites checklist interface]

15-Minute Quick Start​

Step 1: Download and Extract (2 minutes)​

# Download the application bundle
wget https://releases.medfeed.io/latest/medfeed-bundle.tar.gz

# Extract files
tar -xzf medfeed-bundle.tar.gz
cd medfeed-bundle

Step 2: Environment Configuration (3 minutes)​

# Copy environment templates
cp bl-engine/.env.example bl-engine/.env
cp app/.env.example app/.env.local

# Edit backend configuration
nano bl-engine/.env

Essential Environment Variables:

# Database
MONGODB_URI=mongodb://localhost:27017/medfeed
REDIS_URL=redis://localhost:6379

# Security
JWT_SECRET=your-secure-jwt-secret-here
ENCRYPTION_KEY=your-32-character-encryption-key

# AWS Configuration
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key
S3_BUCKET_NAME=your-s3-bucket-name

# Email Configuration
SMTP_HOST=your-smtp-server.com
SMTP_PORT=587
SMTP_USER=your-smtp-username
SMTP_PASS=your-smtp-password

# Application URLs
HOSTED_APP=https://your-domain.com
HOSTED_ADMIN_APP=https://admin.your-domain.com

[Screenshot placeholder: Environment configuration file]

Step 3: Database Initialization (2 minutes)​

# Initialize MongoDB collections
cd bl-engine
npm run build
npm run db:seed

# Verify database setup
mongo medfeed --eval "db.stats()"

Step 4: Application Installation (5 minutes)​

# Install backend dependencies
cd bl-engine
npm install --production

# Install frontend dependencies  
cd ../app
npm install --production

# Build applications
cd ../bl-engine && npm run build
cd ../app && npm run build

[Screenshot placeholder: Installation progress terminal]

Step 5: Service Startup (3 minutes)​

# Start backend service
cd bl-engine
npm run deploy:prod

# Start frontend service
cd ../app
npm start &

# Verify services are running
curl http://localhost:3000/health
curl http://localhost:3001

[Screenshot placeholder: Service status dashboard]

Docker Quick Start (Alternative)​

For containerized deployment:

# Clone repository
git clone https://github.com/your-org/medfeed.git
cd medfeed

# Configure environment
cp .env.example .env
nano .env

# Start with Docker Compose
docker-compose up -d

# Check status
docker-compose ps

[Screenshot placeholder: Docker containers running]

Initial Configuration​

1. Create Admin Account​

Navigate to https://your-domain.com/admin/setup and create the first admin user:

[Screenshot placeholder: Admin account creation form]

2. Organization Setup​

Configure your hospital organization:

[Screenshot placeholder: Organization setup form]

  • Hospital Name: Your Hospital Name
  • Address: Complete hospital address
  • Contact Information: Phone and email
  • Time Zone: Your local time zone
  • Language: Primary language

3. Department Configuration​

Set up hospital departments:

[Screenshot placeholder: Department configuration interface]

  1. Click "Add Department"
  2. Enter department details:
    • Name (e.g., "Emergency", "Cardiology")
    • Code (e.g., "ER", "CARD")
    • Head of Department
    • Contact information

4. User Roles and Permissions​

Configure user roles:

[Screenshot placeholder: Role management interface]

Default Roles:

  • Doctor: Clinical documentation, patient feedback access
  • Nurse: Patient feedback, task management
  • Administrator: Full system access
  • Quality Manager: Reports and analytics access

SSL Certificate Setup​

Using Let's Encrypt (Free)​

# Install Certbot
sudo apt install certbot python3-certbot-nginx

# Generate certificate
sudo certbot --nginx -d your-domain.com

# Auto-renewal setup
sudo crontab -e
# Add: 0 12 * * * /usr/bin/certbot renew --quiet

Using Custom Certificate​

# Copy certificate files
sudo cp your-certificate.crt /etc/ssl/certs/
sudo cp your-private-key.key /etc/ssl/private/

# Update Nginx configuration
sudo nano /etc/nginx/sites-available/medfeed

[Screenshot placeholder: SSL certificate status]

Nginx Configuration​

Create /etc/nginx/sites-available/medfeed:

server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name your-domain.com;
    
    ssl_certificate /etc/ssl/certs/your-certificate.crt;
    ssl_certificate_key /etc/ssl/private/your-private-key.key;
    
    # Frontend
    location / {
        proxy_pass http://localhost:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    # Backend API
    location /api {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Enable the site:

sudo ln -s /etc/nginx/sites-available/medfeed /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Verification Checklist​

After setup, verify these components:

[Screenshot placeholder: System health dashboard]

Post-Setup Tasks​

1. Invite Staff Members​

  1. Navigate to User Management
  2. Click "Invite User"
  3. Enter email addresses
  4. Select appropriate roles
  5. Send invitations

[Screenshot placeholder: User invitation interface]

2. Configure Integrations​

Set up connections to existing systems:

  • EMR/EHR integration
  • Hospital management system
  • Notification services
  • Backup systems

3. Data Migration (if applicable)​

Import existing data:

  • Patient records
  • Staff information
  • Department structures
  • Historical feedback data

4. Training and Onboarding​

Schedule training sessions:

  • Admin training for IT staff
  • User training for medical staff
  • Department-specific workflows
  • Emergency procedures

Troubleshooting Quick Fixes​

Service Won't Start​

# Check logs
pm2 logs medfeed-backend
tail -f app/logs/error.log

# Restart services
pm2 restart all
sudo systemctl restart nginx

Database Connection Issues​

# Check MongoDB status
sudo systemctl status mongod

# Test connection
mongo --eval "db.adminCommand('ismaster')"

Performance Issues​

# Monitor resources
htop
df -h
free -h

# Check application metrics
curl http://localhost:3000/api/metrics

Next Steps​

After successful setup:

  1. Read the User Guides for detailed feature usage
  2. Configure Advanced Features for your specific needs
  3. Set up Monitoring for production use
  4. Review Security Best Practices

For detailed configuration options, see the Installation & Setup Guide.