See the Avalon 7.1 release notes for more information.


Avalon 7.1 and above requires Ruby 2.5 or newer. If you're using RVM, simply run

rvm list # Get current ruby version, eg 2.2.1
rvm upgrade 2.2.1 2.5.5 # Installs Ruby 2.5.5 and migrate gemsets, wrappers, aliases and environment files

Config changes

Old settingNew settingNote


      address: ''
      port: 587
      enable_starttls_auto: false

  mailer: :smtp  # or aws_sdk if using Amazon SES
    port: 25
    enable_starttls_auto: false

Upgrade Steps

For Manual Installations

  1. Download and deploy new code from the avalon repository.
  2. Update gems, and migrate DB
bundle install --with production --without development test
RAILS_ENV=production bundle exec rake db:migrate

3. Update JS dependencies

yarn install # in Avalon root dir

4. Update configuration, see Config changes above

5. Restart passenger (if using)

passenger-config restart-app

For Docker Installations

Update new code from avalon-docker

git checkout master
git pull

Pull or Rebuild Avalon container. 

docker-compose pull avalon
# or docker-compose build --no-cache avalon

Check config changes then replace the Avalon containers

docker-compose up avalon worker