Home
If you have already installed v1.0.3, you must uninstall it first - see 1.0, and then install 1.0.4.
If you’ve never installed Olympus before, then you can go to [2.0].
If you didn't change anything in your units databases then don't worry there is nothing to do in this step, skip ahead to the next section.
If you did make changes to the Olympus database, like adding units or mods you’ll want to make a copy of these so you don’t lose them.
For most people they live in your Saved Games\DCS.openbeta\Mods\Services\Olympus\client\public\databases folder
If you went really crazy and fully added some new planes, weapons and weapons loadouts make copies of any files you changed as well before we uninstall everything.
There were two ways you could have installed v1.0.3.
A. If you installed via an installer, go to [1.2.2] Case A: Uninstalling 1.0.3 if you installed via an installer;
B. If you manually unzipped the files into the correct locations, go to [1.2.3] Case B Uninstalling 1.0.3 if you installed via a zip.
You’ll need to remove it via Windows ‘installed apps’.
- Open the Start Menu.
- Click Settings, which looks like a cogwheel.
- Click Apps.
- Select Apps & features from the left-hand side menu.
- Find the Olympus program in the list that appears.
- Click the uninstall button that shows under the selected program or app.
If you didn’t see Olympus in your list and you were expecting it to, check very carefully before proceeding and/or consider if you maybe installed via the zip and forgot.
Once uninstalled go to [1.2.4] Removing the DCS Hooks and Scripts.
Olympus needs to be removed from your DCS ‘Saved Games’ folder which most commonly is found in:
\Users\[user]\Saved Games\DCS.openbeta\Mods\Services\Olympus
- Remove this Olympus folder and its contents.
Note: The folder name and location can vary. It needs to be correct for your system. If you installed to a custom folder location, go there instead.
- Check your
\Users\[user]\Saved Games\folder. - Remove any duplicate folders related to Olympus if they exist here.
Once uninstalled, go to [1.2.4] Removing the DCS Hooks and Scripts
Note: If you installed Olympus on multiple DCS instances you will obviously have to do this step for each instance.
In case something went wrong during the uninstall process, we need to remove the Olympus Hook. To do this, navigate to:
\Users\[user]\Saved Games\DCS.openbeta\Scripts\Hooks\
You may have a file called ‘OlympusHook.lua’, delete this file and only this file.
Once done go to [1.2.3] Removing the net shell (netsh) rule.
People who setup Olympus to be accessible from other machines - e.g. people using Olympus on a server, or PC acting like a server - will probably have setup a netsh rule. We’ve removed the requirement for this in v1.0.4, so let's tidy this up to allow Olympus to work properly and for security.
The best way to check is to open up ‘command prompt’ and enter:
netsh http show urlacl
You are going to see a lot of results. You are looking for things ‘Olympus related’, e.g. you may have a rule, or similar rules, which say:
http://*:3001/olympus user=OlympusUser
where 3001 may have a different value and OlympusUser will be your user.
If you see any, you should remove them using the following command:
netsh http remove urlacl url="http://*:3001/olympus/"
Take care to ensure you replace the relevant text with what it should say for your entry.
If you got this far, you have successfully removed Olympus v1.0.3 from your system.
**If you have jumped ahead and you haven’t already uninstalled Olympus 1.0.3, you must go back and remove it first. Do not skip this step, otherwise... Well you’ve been warned. **
There is also a video showing you this same information which is probably a lot easier to follow, [youtube link] though this guide has a little extra information within it for more niche setups.
Go to the Github page and take a look at the releases page and download the ‘manager’ version if you want to install Olympus on either your own machine or as a server.
Ignore the archive version, which is for a tiny, tiny, subset of people who automatically deploy Olympus - who shouldn’t need instructions to know what to do with it, so there aren’t any.
DO NOT extract the download into your DCS Saved games folder or your actual DCS install, that isn’t where it should go.
Find a suitable location for the file on your computer. We recommend making a folder inside your Downloads folder, but it can be extracted anywhere really.
Once you’ve done that, take a look at the extracted files and locate the installer script. Note, there is another filed called install inside the Manager folders, ignore it.
Run the script and follow the relevant prompts. Read, don't just click blindly. You might be keen to see this new version but you may ruin things for yourself by skipping ahead too quickly.
The install will download a few prerequisites automatically, such as Node and the Olympus application. This might take some time, depending on your internet connection and whether you already had any of the prerequisites. Don’t worry if you didn’t have all the pre-requisites as the installer script will get them for you - it just takes a little longer.
Before we get to the manager, it is useful to understand how Olympus is set up.
Each computer with DCS installed on it has an instance of DCS. Most users will have only one instance, which is the one they load when running DCS. Some server owners run two DCS servers from one machine: e.g. they have "DCS Server 1" and "DCS Server 2" but these are installed in two different folders on that same machine.
DCS Olympus now works by having the central manager application, which manages each instance of DCS. So, in the case where a server owner runs two servers on one machine, they will have two instances in their manager, allowing them to do things like set ports and passwords independently on each instance. Again, most people will have only one instance and this is expected.
There are also some core important changes to how Olympus works now, so you shouldn’t need to ever run DCS as an admin for Olympus to work or do local firewall exceptions to use it on just your PC.
To install an ‘Olympus instance’, either run the shortcut on your desktop or find it and run it from within the relevant Olympus folder you made earlier.
Once that opens up, you’ll see a bunch of useful things, like User and Troubleshooting guides.
We call the default install mode ‘Basic mode’ but there is nothing basic about it - it just means it’s ‘easy’ to use. In fact, it’s what we use to install Olympus ourselves. The eagle-eyed will have noticed there is also an ‘Expert mode’ for those who need to fettle more. This isn’t a challenge or a fun hard game mode, it just doesn’t guide you through things logically and makes it easier to pick the wrong settings. Expert mode is primarily for managing complicated setups.
So let's keep going with basic mode. Click ‘Add Olympus’.
The manager will detect where your DCS Saved Games folders are and give you the option to install to them. Naturally, you should pick the folder into which you want to install it. Most people likely have just one folder and not be given a choice. If you do later try install again over this folder, it’s like a factory reset of the install.
All this really means is do you want to only use and control Olympus from this computer, if you do pick Singleplayer.
If you want others to be able to control this instance of Olympus from other computers - including other devices - pick Multiplayer.
You can always reinstall again if you change your mind.
We can now set these port settings for you, or if you want to pick different defaults, you can do that instead.
We recommend you pick ‘Auto apply settings’ and click Next.
However, by choosing Manually set the next screen will give you options to pick manually a frontend or backend port.
If you picked ‘Auto apply settings’, go to [2.4.7] Pick some passwords.
You will be prompted to pick ports for the front and backend port. The green tick indicates this port is probably free for use and not taken by another running process or Olympus instance. Note: you might have to click on the screen to see this update.
However, if a port isn't in use because the application which uses it isn't running currently, it may cause issues when it does. If you have any problems, just come back here and pick a free port.
Leave the option unchecked for ‘Enable direct backend API connection’ it’s no longer needed for Olympus unless you are doing some real niche custom modding things, we’ll probably tell you in Discord if you should enable this otherwise leave it unchecked.
This step is so obvious, I don’t think we are going to tell you how to do this.
Remember to pick secure, long, passwords if you will be using this over the internet and not just on your PC. Obligatory XKCD
All passwords must also be different within each instance.
If you have Olympus already installed, with chosen passwords, you can click Next to keep the same passwords.
We’ve got a new camera control plugin which lets you move the DCS camera around in missions to wherever you are looking within DCS, which is really neat.
Obviously, we recommend you install this because it’s cool but here you get the option if you don’t want to.
Importantly, if you want to use the camera control functionality, even with other people’s Olympus servers or machines, you’ll need to install the plugin for yourself by saying install here as it connects to your local DCS, this isn’t a server-side thing.
Other requirements:
- Use Google Chrome;
- If you are connecting to a remote server (i.e. not to your local machine) then that server MUST serve pages using https (ask your friendly, local server administrator).
Should you want to remove the plugin, go through the Olympus manager again and instead of saying "install it here", just say "no" and it will be removed.
You might get a prompt to Allow Electron to run - but not everyone will. It’s something we use to build Olympus. Electron is made by GitHub, which you can have a read about on the internet.
If you see the prompt, click ‘Allow’ and you will finish your Olympus install.
Okay, hopefully that worked for you and you can launch Olympus. Follow the instructions on screen. You don’t need the manager open to run Olympus with DCS.
Remember: to load up a mission and remember to unpause the game/server or Olympus can’t do anything!
Once you’ve installed an Olympus instance, you’ll see it listed here. Clicking ‘Edit Settings’ will walk you back through the wizard again to amend the relevant settings. You can also see ‘Open logs’ that will open the two logs people need to help troubleshoot issues.
It may appear that only one log window has been opened, but sometimes one log window sits over the other, so move the one you can see in case it's hiding the second.
You can also uninstall that specific Olympus instance as well. This doesn’t remove every instance of Olympus from your machine, just that specific one. If you want to remove them all you’ll have to repeat this process for each installed instance.
If you do have problems, or want to change any settings, you can ‘Return to the main window’ and instead click ‘Change settings’. This is also how you find the super important logs you must share with us if you want help from people in our DCS Olympus Development Discord server. See the #troubleshooting channel.