Hosting Your Own Launch Server

Hosting Your Own Launch Server

You can host Veracity Launch on your own server! We offer a version of our software that we packaged as a standalone executable file with no specific dependencies, other than MongoDB. 

Simple Installation – Default Configuration

Running Veracity Launch on your own servers is as easy as downloading and running a file:
  1. You must install MongoDB (or set-up a hosted MongoDB server) and it must be running before you run the Launch server software.

  2. Request the Launch (Lite) Software and download the version for your operating system from the software repository at the link in the email reply: 
    1. Windows — VeracityLaunch-win.exe
    2. Linux — VearcityLaunch-linux
  1. Execute the file to start the Launch server in its default configuration. You must run the executable file as a service:
    1. Windows — Use Task Scheduler, or a third-party service manager like NSSM.
    2. Linux — Use systemd to run this simple service script:
[Unit]
Description=veracitylaunch
After=network.target

[Service]
WorkingDirectory=/home/ubuntu
ExecStart=/home/ubuntu/VeracityLaunch-linux
Type=simple
PIDFile=/run/veracitylaunch.pid
Environment=""

[Install]
WantedBy=default.target

Manual Installation – Custom Configuration

  1. Install MongoDB.
    You must install MongoDB, or set-up a hosted MongoDB server.

    MongoDB is very popular and has great documentation to get you started. We recommend MongoDB Atlas, although MongoDB Community Server is compatible. Launch can use any version of MongoDB later than 6.0.

    You do not need to install the database on the same server as the Launch software. In general, it's a good idea to keep the database and the webserver on different machines.

    If you have MongoDB Enterprise Server, then you should consider creating a replica set to ensure the maximum uptime.

  2. Start MongoDB.
    MongoDB must be running before you can configure the Launch server. You'll also want to make sure that MongoDB starts each time the server reboots.

  3. Request the Launch (Lite) Software.
    The email reply includes a link to the repository of the latest build of the Launch software.

  4. Download the executable file.
    The file has the prefix VeracityLaunch- followed by a string for your operating system:
    1. Windows — VeracityLaunch-win.exe
    2. Linux — VearcityLaunch-linux
  1. Execute the file.
    Using a command prompt (or terminal), execute the file with the --configure option. This begins the setup process.

    On Linux, you may need to set the permissions on the file to allow it to execute.

    Also, be sure that the user running the file has write access to the directory the file is in. Otherwise, the system may not have permission to create its own configuration file.

  2. Answer the questions.
    Answer the questions as presented by typing into the console and pressing Enter. Be sure to answer Yes to the final question. This writes-out an .env file that will contain your configuration settings. You may manually edit this file and restart the server to update the configuration.
Notes
See the How to Configure Your Launch Server article for more information.
  1. Run the executable again.
    The server will start up and begin serving requests on the port you specified! 

Lite versus Enterprise Mode 

Depending on your license key, Launch may run in either Lite or Enterprise mode. 

Lite Mode

  1. If you don’t have a license key, then Launch runs in Lite mode.
  2. You can host only a single Launch Portal. 
  3. No Platform Administrator login. 

Enterprise Mode

  1. Multi-tenancy — manage multiple portals, user accounts, and quotas.
  2. System level logging and metrics.
  3. Access to Delegate™ and the Platform API.

Signing-in to Lite Mode for the First Time

When the server starts up in Lite mode, it creates a learning portal and a default administrator account. The username is admin@${hostname} and the password is Password1!. You must change this password on your first Sign-in. 

In the username, the ${hostname} value is the value from the host file when the server first starts. If you've changed it after first start, then it creates the account with the original value. The default value is locallxp.veracity.it.