CollabVM Server 1.x/Admin Panel



The Admin Panel lets you configure nearly everything in CollabVM.

From here, you can delete, create, and add virtual machines, as well as remotely manage them and change many settings in the server configuration. Be careful giving your admin panel to other users, because like all admin panels, it can be used as a weapon of mass destruction if used maliciously.

This page will document all the features found in the Admin Panel.

How to access it
To access the Admin Panel, you can go to wherever you put your admin webapp ( http://127.0.0.1:(collab-vm-server port)/admin/ (replace 127.0.0.1 with your IP address if different)). If you are running on an older version of CVM Server (older than 1.2.9) you will need to edit the admin.min.js file.

By default, the admin password is collabvm. It is recommended to change this immediately, since it is highly insecure (any password we put on here by default would be insecure, no matter the complexity).

Chat Message Rate

 * Default value: 4 messages per 3 seconds

This is the built in anti-spam feature CollabVM has. By default it allows you to send 4 messages in 3 seconds before muting for 30 seconds.

If you want to disable the anti-spam, set this value to 0. Moderators or admins can bypass the anti-spam completely.

Chat Mute Time

 * Default value: 30 seconds

If a user spams above the values set in "Chat Message Rate", they will be muted for however many seconds you specify in here. For example, if you set this to 60, a user who spammed the chat would be muted for 60 seconds (1 minute).

Max Connections From One IP

 * Default value: 5 connections

To prevent users from racking up turns, the server has a built-in feature that denies connections from users with too many connections open. So, if this is set to 3, you can only connect to the VM 3 times per one IP address.

If you want users to be able to open infinite connections, set this to 0.

Upload Timeout

 * Default value: 120 seconds

If you are using the CollabVM Agent, you can set the timeout for file uploads here.

Ban IP Command

 * Default value: (none)

If you want to be able to use the "Ban User" button on the VMs, you will have to add in a Ban IP command.

Example commands:


 * BSD:
 * Linux:
 * Linux (with ipset):
 * Windows Vista/Server 2008 and up:  (the backslashes is because of rapidjson)

JPEG Compression Quality

 * Default value: 75 (percent)

If you are using a build of the server with JPEG support compiled in (you will not see this if you're using a build without it), you can set the compression quality. It is not recommended to set it below 30, and the text will become unreadable at very low levels.

Blacklisted usernames

 * Default value: (none)

To prevent impersonation of other users, you can add a blacklist of usernames. Moderators and Admins are able to bypass this, so it is recommended to add a list of moderators and admin usernames. To add usernames, you simply do this:

Enable Moderator Rank

 * Default value: false

This will enable the "moderator" rank on your server. Moderators are similar to admins, except they have a green username and can be limited in what they can do (by default, admins have all permissions).

Moderator permissions
Administrators also have "VM Monitor" when logged in as admin on the VM


 * Restore Snapshot
 * This permission allows to forcibly restore the virtual machine (as if a vote reset passed) to its original state.


 * Reboot VM
 * This permission allows to forcibly restart the virtual machine.


 * Ban Users
 * This permission allows to ban users (this will only work if a Ban IP Command has been set).


 * Kick Users
 * This permission allows to kick users.


 * Force Votes
 * This permission allows to force vote resets to either pass or fail, regardless of the current vote.


 * Mute Users
 * This permission allows to mute users - it can be a temporary (whatever's specified in "Chat Mute Time") or permanent mute.


 * Bypass & End Turns
 * This permission allows to bypass (allows you to shoto at the top of the turn queue, ending the current turn) and end turns, as well as clear the turn queue.


 * Rename Users
 * This permission allows to forcibly rename users.


 * Copy IPs
 * This permission allows to copy IP addresses.

Change Master Password
This is the password you will use to login as an admin and login to the admin panel in CollabVM. By default the password is collabvm. CHANGE IT IMMEDIATELY!!! The default password is EXTREMELY insecure!
 * Default value: collabvm

Change Moderator Password
This is the password you will use to login as a moderator. By default the password is cvmmod. Once again you will want to change this immediately if you have the mod rank enabled.
 * Default value: cvmmod

Auto Start
If you want the VM to start when your server starts up, enable this.
 * Default value: false

URL Name
The URL name is what your VM's internal name will be. Most people will leave this as something like "win7", "win10", "debian", etc.
 * Default value: (none)

Display Name
This is what will display when people see your VM in a list, so make it something descriptive, for example "Windows 7 Professional x64 SP1".
 * Default value: (none)

Because the display name is not sanitized in the webapp, you can put HTML tags in the display name, thereby meaning you can extend the display name by putting a  tag after your VM name and adding in a description or whatever you want. But keep in mind, if you're going to put your VM on the UserVMs, you'll have to get rid of your XSS as it is not allowed.

MOTD
This is the message that you will see when you join a VM. This can be anything.
 * Default value: (none)

VNC Address
The VNC IP Address. It is highly recommended to keep this as 127.0.0.1.
 * Default value: 127.0.0.1

VNC Port
The VNC Port. You should only need to change this if you are already running a VNC Server on 5900 or you are running multiple VMs. If you are, selecting the input box and pressing the up arrow should work fine.
 * Default value: 5900

QMP Socket Type
The QMP Socket Type. You should normally not have to touch this.
 * Default value: Local

QMP Address

 * Default value: localhost

The QMP Address. You should normally not have to touch this.

QMP Port
The QMP Port. You should normally not have to touch this.
 * Default value: 5800

Max Guacamole/QMP Connection Attempts
If your server has a lot of stuff running, has a slow CPU, or low memory, it might take a bit for QEMU to actually start. You can configure the maximum attempts here.
 * Default value: 5

Hypervisor
Right now, the only working hypervisor is QEMU, so there's nothing to change.
 * Default value: QEMU

Start Command
The start command for your VM goes here. For example:
 * Default value: (none)

Snapshot Mode

 * Default value: off

The "Snapshot Mode" is required if you want to use Vote Resets. After you install your VM, you should set this to "Hard Drive Snapshots" otherwise all changes made to the VM will be permanent.

Restore After Shutdown
If you want your VM to restore after it is shut down, you can enable this option. It is recommended to use Vote Resets instead.
 * Default value: false

Turns Enabled
If you want turns to be enabled, check this box.
 * Default value: false

Turn Time
How long you want each users turn to last. i.e. If you want turns to last 18 seconds, set this number to 18.
 * Default value: 20 seconds

Votes Enabled
If you want vote for resets to be enabled, check this box. Note that the Snapshot Mode must be set to "Hard Drive Snapshots" for this to work.
 * Default value: false

Vote Time
Determines how long each vote reset should last.
 * Default value: 60 seconds

Vote Cooldown
Determines how long it takes before another vote for reset can begin.
 * Default value: 120 seconds