Platform Contributor Guide
[Legacy v3] Platform
[Legacy v3] Platform
  • 👋[Legacy v3] Welcome | README
  • Contributing | Getting Involved
    • Specific tasks needed for COVID19-support
    • Add code to Ushahidi
    • Encouraging contribution from non-developers
  • Frequently Asked Questions
  • Join the Ushahidi community
  • Contributors ✨
  • 🛣️ The Ushahidi Platform Roadmap
    • V2-V3+ Migration tool
  • Privacy and security best practices
    • Security as a user
    • Security for deployment admins
    • Security for deployment hosts
  • Development & Code
    • Development: Overview
    • How to get the source code
    • Setup Guides
      • Installing for production environments
      • Development environment with XAMPP
      • Development environment setup with Vagrant
      • [Client] Setting up the Platform Client for development
        • Migration from AngularJS
      • Setting up the Pattern Library for development
      • [API & Client] Bundled release install
    • Add code to Ushahidi
    • Development process
    • Coding Standards
    • Track and submit issues in Github
    • Upgrading Ushahidi
      • Upgrading to latest release
      • Upgrading from V3.x.x to V4.x.x
    • ⚙️ Installation Helper‌
  • Tech Stack
    • API Documentation
    • Third party app development
      • Web hooks
    • Database | Tables overview
    • Database | Database Schema Diagram
    • Database | Table details
    • 📐Architecture
    • Use case internals
  • QA & Testing
    • The QA process
    • How to run QA tests
    • Defect Management
    • How to write QA test scripts
    • Hotfixes
  • Front-end development
    • Changing UI styles: introduction to the pattern library
      • File-structure
      • Installing new packages
      • How to Apply to the Platform
      • Using the changed styles in platform-client
      • Syntax and Formatting
      • Grid, Breakpoints, & Media Queries
      • Variables
      • Mixins
      • Helpers
      • Icons
      • Create a New Component from Scratch
      • Read Direction
  • Design
    • 🎨Design: overview
    • 'Best practice' design
    • Ushahidi Platform 'Sticker Sheet'
    • User testing process
    • User testing script examples
    • Synthesising user testing results examples
      • Synthesis example 1
      • Synthesis example 2
      • Synthesis example 3
      • Synthesis recommendations example 1
      • Synthesis recommendations example 2
    • Open Source Design
  • Documentation
    • Documentation
    • Contributing docs via GitHub
  • Translation
    • Localization and Translation
  • The Ushahidi Platform Facebook bot
    • The Facebook bot
      • Installing the bot
      • The bot script
  • Hackathon and events
    • Installathon, May 2019
      • Welcome to the hackathon!
    • Write/Speak/Code 2019
    • Open Design: Bangalore
    • Open Design: Taipei
    • 📑Google season of docs
    • 💻Google Summer of Code
      • GSoC 2024
  • Enhancement Proposals
    • Exchange Format
    • Importing data from previous versions
Powered by GitBook
On this page
  • Updating your deployment to the latest version
  • Updating the client (for developers)
  • Updating the API (for developers)
  1. Development & Code
  2. Upgrading Ushahidi

Upgrading to latest release

PreviousUpgrading UshahidiNextUpgrading from V3.x.x to V4.x.x

Updating your deployment to the latest version

Instructions on how to upgrade your Ushahidi deployment.

  1. Make a backup copy of the current folder where you have installed the Ushahidi Platform.

  2. Make a backup copy of your database.

    1. The exact procedure to do this depends on your environment.

  3. Download the latest .tar.gz file from our . Please note that pre-releases are not considered stable and you may find issues with them.

  4. Uncompress the downloaded file on the same location where the Ushahidi Platform is currently installed.

  5. If you had made any changes to .htaccess files, application config files or similar after installation, restore those from your backup copy.

  6. Re-run some of the installation steps (refer to the for more detailed instructions). In particular, re-run these two steps

    1. Running database migrations

    2. Ensuring that log, cache and media/uploads under platform/application are owned by the proper user

Updating the client (for developers)

From your local repository fetch the latest code and run `npm install` to update your modules:

git pull
npm install
gulp build

The updated version should load when you reload your browser.

Updating the API (for developers)

From your local repository fetch the latest code and run `bin/update` or `bin/update --production` if you are running on a production environment:

git pull
bin/update

OR

bin/update --production
github releases page
installation guide