Running in a terminal¶
For most users, it is probably preferable to run Mopidy as a service so that Mopidy is automatically started when your system starts.
The primary use case for running Mopidy manually in a terminal is that you’re developing on Mopidy or a Mopidy extension yourself, and are interested in seeing the log output all the time and to be able to quickly start and restart Mopidy.
To start Mopidy manually, simply open a terminal and run:
For a complete reference to the Mopidy commands and their command line options, see mopidy command.
You can also get some help directly in the terminal by running:
To stop Mopidy, press
CTRL+C in the terminal where you started Mopidy.
Mopidy will also shut down properly if you send it the
TERM signal to the
Mopidy process, e.g. by using
pkill in another terminal:
When running Mopidy for the first time, it’ll create a configuration
file for you, usually at
~ in the file path automatically expands to your home directory.
If your username is
alice and you are running Linux, the config file will
probably be at
As this might vary slightly from system to system, you can check the first few lines of output from Mopidy to confirm the exact location:
INFO 2019-12-21 23:17:31,236 [20617:MainThread] mopidy.config Loading config from builtin defaults INFO 2019-12-21 23:17:31,237 [20617:MainThread] mopidy.config Loading config from command line options INFO 2019-12-21 23:17:31,239 [20617:MainThread] mopidy.internal.path Creating dir file:///home/jodal/.config/mopidy INFO 2019-12-21 23:17:31,240 [20617:MainThread] mopidy.config Loading config from builtin defaults INFO 2019-12-21 23:17:31,241 [20617:MainThread] mopidy.config Loading config from command line options INFO 2019-12-21 23:17:31,249 [20617:MainThread] mopidy.internal.path Creating file file:///home/jodal/.config/mopidy/mopidy.conf INFO 2019-12-21 23:17:31,249 [20617:MainThread] mopidy.__main__ Initialized /home/jodal/.config/mopidy/mopidy.conf with default config
To print Mopidy’s effective configuration, i.e. the combination of defaults, your configuration file, and any command line options, you can run:
This will print your full effective config with passwords masked out so that you safely can share the output with others for debugging.