Administrative Guide

Restart's Metabase instance runs as a service. To start/stop/restart:

sudo service metabase [start|stop|restart]

File locations:

• Installation: /opt/metabase/current
• Embedded database: /opt/metabase/current/var/metbase.db.*
• Config: /etc/default/metabase
• Logs: /var/log/metabase.log

Updates

We're using the jar version of metabase for now.

  NEW_VERSION_NUM=0.40.4
  cd /opt/metabase
  service metabase stop
  mkdir $NEW_VERSION_NUM
  cp -R current/* $NEW_VERSION_NUM 
  rm current
  ln -s /opt/metabase/$NEW_VERSION_NUM current
  cd current/lib
  rm metabase.jar
  wget https://downloads.metabase.com/v$NEW_VERSION_NUM/metabase.jar
  cd /opt/metabase
  chown -R metabase:root $NEW_VERSION_NUM
  systemctl daemon-reload # because the file changed on disk.
  service metabase start

Troubleshooting

Bad Gateway 502

This is likely an error from nginx, when it is unable to connect to the Metabase instance. Most likely metabase has not started correctly after a server reboot. Start the metabase service manually (see above), and try again.