Skip to content

Where Are My Files?

MT Showcase files are organized across multiple folders:

The MT Showcase Data Folder

(Applies to Ubuntu and Windows application computers.)

The MT Showcase server keeps the data it manages in a single folder:

  • Ubuntu application computers: /var/lib/mt-showcase-server

  • Windows application computers: %APPDATA%\mt-showcase-server

    Where %APPDATA% refers to the profile of the user the MT Showcase server runs as. If that user is multi, the expanded path is: C:\Users\multi\AppData\Roaming\mt-showcase-server

The folder contains:

  • showcase.db -- the main application database.
  • showcase-reporting.db -- the reporting database used for data gathering.
  • assets -- the media library: images, videos and other uploaded content.
  • sites -- hosted site files.
  • tmp -- temporary working files.
  • exports -- exported showcase files.
  • backups -- backups created by mt-showcase-ctl. On Windows application computers, the default backups folder is %LOCALAPPDATA%\MultiTaction\showcase\backups instead.

On Windows application computers, the TLS certificate the Editor is served over is kept separately, in %PROGRAMDATA%\mt-showcase-server\certs.

This is the folder to back up

Everything specific to your installation lives here. Include this folder in your own backup routine, alongside the backups created by mt-showcase-ctl; see backup-restore. Note that an mt-showcase-ctl backup covers the application database, the reporting database and the media assets -- it does not include hosted sites or the TLS certificate, so copy those yourself if you need them.

Where Are the *.yaml Configuration Files?

MT Showcase reads two server configuration files:

  • production.yaml is part of the installed package. It holds the default settings and is overwritten every time you upgrade MT Showcase. Never edit it: your changes are lost on the next upgrade.
  • production_users.yaml is the file you edit. It is preserved across upgrades, and the settings in it override the defaults in production.yaml.

Where is production_users.yaml?

If you need to edit production_users.yaml, find the file here:

  • Ubuntu application computers: Find the file here: /etc/MultiTaction/mt-showcase/server/production_users.yaml
  • Windows application computers: Find the file here: C:\Program Files\MT Showcase\server\production_users.yaml

Note

You need to edit this file if you want to:

  • Change server settings such as HTTPS certificates or SMTP; see configuration.
  • Set up data gathering. As part of the setup, you must configure MT Showcase to use a reporting database.
  • Change the default backup folder.

Where Are the Log Files?

Server Log Files

Log entries are generated each time the MT Showcase server starts.

  • Ubuntu servers: Ubuntu 24.04 uses systemd instead of upstart. View server logs with:

    journalctl -u mt-showcase-server

    Log files are also written here: ~/MultiTaction/showcase/logs/

    Where ~/ refers to the runtime user's home folder. If the user logged on when the MT Showcase server starts is multi, the expanded path is: /home/multi/MultiTaction/showcase/logs/

  • Windows servers: Log files are here: %PROGRAMDATA%\MultiTaction\showcase\logs

    Where %PROGRAMDATA% refers to the machine-wide application data folder, normally: C:\ProgramData\MultiTaction\showcase\logs

    Log files take this file name format: log<YYYY-MM-DD_HHmmss>-<n>.log

    Where <YYYY-MM-DD_HHmmss> is the time the log was started and <n> is a sequence number. This folder is machine-wide rather than per-user, so the logs are in the same place whichever user the server runs as.

    This is a single, appended log file rather than one file per date. The MT Showcase client writes to the same file, so server and client entries appear together in chronological order; see client-log-showcase below.

Client Log Files: Generated by MT Launcher

Applies when MT Showcase is started from MT Launcher.

Log entries are generated each time MT Showcase is started from MT Launcher. MT Showcase client logs take this file name format: mt-showcase-<ver>-<date>.log

Where <ver> is the MT Showcase version.

  • Ubuntu application computers: Log files are here: ~/MultiTaction/launcher/logs/

    Where ~/ refers to the runtime user's home folder. For example, if the user logged on when MT Showcase starts is multi, the expanded path is: /home/multi/MultiTaction/launcher/logs/

  • Windows application computers: Log files are here: %LOCALAPPDATA%\MultiTaction\launcher\logs

    Where %LOCALAPPDATA% refers to the runtime user's profile folder. For example, if the user logged on when MT Showcase starts is multi, the expanded path is: C:\Users\multi\AppData\Local\MultiTaction\launcher\logs

Note

For full details about licensing, see licensing.

The MT Showcase license is installed in the home folder (Ubuntu) or user profile (Windows) of the user who was logged on when the license was first activated:

  • Ubuntu application computers: The license is saved to ~/MultiTaction/Licenses

    Where ~/ refers to the home folder of the MT Showcase runtime user. If the user logged on while MT Showcase runs is multi, the expanded path is: /home/multi/MultiTaction/Licenses/

  • Windows application computers: The license is saved to %LOCALAPPDATA%\MultiTaction\Licenses

    Where %LOCALAPPDATA% is the MT Showcase runtime user's profile. If the user logged on while MT Showcase runs is multi, the expanded path is: C:\Users\multi\AppData\Local\MultiTaction\Licenses