Skip to content

Sign in to a server

This page explains the sign-in screen of the Android app: what to type in each field, how an invitation link works, what each error message means, and how to log out. It works with Musonic Server and with other Subsonic servers (Navidrome, for example).

What you need

  • Musonic installed on your phone (Install the Android app).
  • The address of the server, your username and your password. If someone runs the server for you, they give you these, or an invitation link.
  1. Open Musonic.

    The first time, the app opens on its sign-in screen: the Musonic logo, “Connect your Subsonic server”, and three fields: Server URL, Username and Password. The grey admin and dots are only examples, not filled in. The Connect button stays dimmed until the three fields are filled.

    Musonic's sign-in screen, empty: the logo, the line 'Connect your Subsonic server', the fields Server URL (holding https://), Username and Password, and the Connect button dimmed.
  2. In “Server URL”, type the address of your server after https://.

    For example https://music.example.com. The field already holds https://: keep it. Type only the address, without /rest or anything after it.

  3. In “Username”, type your username.

  4. In “Password”, type your password.

  5. Tap “Connect”.

    The button turns into a spinner while Musonic checks the server, then shows “Connected! Loading…” in green and opens the Home screen.

    The sign-in screen filled in: Server URL https://music.example.com, a username, a hidden password, and the Connect button now bright, ready to tap.
Your server is Type Example
Reachable from the internet, with a certificate https:// and its name https://music.example.com
On your home network http://, its local address and its port http://192.168.1.20:4533

4533 is the port Musonic Server uses by default. If you are not sure, open the same address in the phone’s browser: Musonic Server answers with its console or a page about the server.

http:// is only accepted on your home network. On the internet, a plain http:// address would send your password without encryption, so Musonic refuses it. These addresses are accepted with http://:

  • private IPv4 addresses: 192.168.x.x, 10.x.x.x, 172.16.x.x to 172.31.x.x;
  • Tailscale addresses, 100.64.x.x to 100.127.x.x;
  • localhost, link-local addresses, and IPv6 local addresses (fc.., fd.., fe80..);
  • names ending in .local, .lan, .home.arpa or .internal, and one-word names such as http://nas:4533.

Even then, the app shows under the address: “Using HTTP instead of HTTPS. Your credentials may be sent in plaintext.” It is a reminder, not an error.

What the app keeps instead of your password

Section titled “What the app keeps instead of your password”

Your password is used once, to sign in. The app then keeps something else:

  • Musonic Server: a key for this phone, named after it (for example “Musonic Android · SM-A525F”). It is listed with your devices in the console, where it can be revoked. The password is not stored.
  • Other Subsonic servers: a token computed from the password. If the server refuses tokens (some servers checking passwords against a directory do), the password itself is kept on the phone.

On Musonic Server, the administrator can send you an invitation link instead of creating your account. You choose your name and your password yourself; the administrator never sees the password.

  1. Open the invitation link.

    It looks like https://music.example.com/invite/…. Open it in the phone’s browser, or on a computer.

  2. Choose your name, then your password twice.

    The page says “Welcome to Musonic” and who invites you, with the fields Name, Password and Confirm the password. The name is the one you will type in “Username” to sign in. The password needs at least 8 characters.

    The invitation page in the phone's browser: the Musonic logo, 'Welcome to Musonic', the line 'alice invites you. Choose your name and your password.', the fields Name, Password and Confirm the password, the button Create my account, and the date the link is valid until.
  3. Tap “Create my account”.

    The page says “Your account is ready” and shows the server address to use, to add in the Musonic app (or another Subsonic app such as Substreamer or Symfonium).

    The invitation page after creating the account: 'Your account is ready', the server address in a box, and the line asking to sign in with the name and password just chosen.
  4. In Musonic, sign in with that address, your name and your password.

    Follow Sign in above.

An invitation link works once, until the date shown under the form. When it cannot be used, the page says why:

The page says What to do
This link was used already. The account exists: sign in with it.
This link expired. Ask the administrator for a new one. Ask for a new link.
The administrator cancelled this link. Ask for a new link.
This link does not exist. Check it is complete. The link was cut when copied: copy it again, in full.
This name is taken, choose another one. Choose another name.

A password reset link (…/reset/…) works the same way: choose a new password twice, then sign in again in your apps with it.

The message shows in red above the Connect button.

Message What it means What to do
URL, username and password are required. A field is empty, or the address does not start with http:// or https://. Fill in the three fields; keep https:// at the start.
Plain HTTP refused: use HTTPS, or an address on your home network (e.g. http://192.168.1.20:4533). An http:// address that is not on your home network. Use the https:// address.
Wrong username or password The server refused the account. Check both, including capital letters.
Server not found — check the URL No answer at all: typo in the address, server off, phone offline, or a certificate the phone does not trust. Open the address in the phone’s browser to check it.
Connection timed out The server did not answer within 8 seconds. Check the phone’s connection and that the server is running.
No Subsonic server at this address — check the URL Something answered, but not a music server (a web page, a router). Check the address and the port.
Client error (404) — check the URL The server answered with an error in the 400s, often a wrong path. Check the address; remove anything after the server name.
Server error (502) — server is down The server answered with an error in the 500s, often a reverse proxy whose server is stopped. Ask the person who runs the server.
Unable to connect Another problem. Try again; if it lasts, ask the person who runs the server.

The numbers in brackets are examples: the app shows the code the server sent.

Later, the server may refuse the account on its own. The app then comes back to the sign-in screen, with your address and username filled in and the reason above the button:

Message Why
This device was signed out of your account. Please sign in again. The key of this phone was revoked, from the console or with “Sign out everywhere”.
Your account has been suspended. Ask the server’s administrator. The administrator suspended the account. Nothing is deleted.
Did your password change? Please sign in with the new one. The password changed, for example after a reset link.

Type your password and tap Connect: the account is replaced, your downloads and settings stay.

  1. Tap the round button with your initial, at the top left of the Home, Search and Library screens.

    It sits next to the Settings gear. The Profile panel opens from the bottom of the screen, with your initial, your username and the server’s name, then Offline mode, Settings and About.

  2. Tap “Log out” at the bottom.

    Musonic's Profile panel: the account's initial, the username and the server name, the Offline mode switch, Settings, About, and Log out in red at the bottom.
  3. Confirm with “Log out”.

    The app asks first, with your username and the server’s name, and reminds you that you will need your password again.

Logging out deletes this phone’s key on Musonic Server, so it is removed from your devices, and the app forgets the account. Your downloaded songs are not deleted.

The app uses one account at a time, and has no account switcher. To use another account or another server, log out, then sign in with the other one. Your playlists, likes and history stay on each server.